@hubspot/cli 8.3.0 → 8.3.1-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 (825) 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 +20 -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 +13 -13
  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 +28 -33
  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 +605 -52
  150. package/lang/en.js +648 -78
  151. package/lib/CLIWebSocketServer.d.ts +5 -3
  152. package/lib/CLIWebSocketServer.js +31 -4
  153. package/lib/accountAuth.d.ts +4 -1
  154. package/lib/accountAuth.js +53 -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 -1
  165. package/lib/app/urls.js +6 -4
  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 +20 -2
  175. package/lib/constants.js +27 -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/middleware/deprecationWarningMiddleware.d.ts +1 -0
  245. package/lib/middleware/deprecationWarningMiddleware.js +57 -0
  246. package/lib/npm/npmCli.d.ts +1 -0
  247. package/lib/npm/npmCli.js +13 -0
  248. package/lib/npm/packageJson.js +1 -1
  249. package/lib/process.d.ts +1 -1
  250. package/lib/process.js +10 -3
  251. package/lib/projects/ProjectLogsManager.js +7 -7
  252. package/lib/projects/add/legacyAddComponent.d.ts +2 -1
  253. package/lib/projects/add/legacyAddComponent.js +3 -0
  254. package/lib/projects/add/v2AddComponent.d.ts +2 -1
  255. package/lib/projects/add/v2AddComponent.js +7 -1
  256. package/lib/projects/builds.d.ts +2 -0
  257. package/lib/projects/builds.js +22 -0
  258. package/lib/projects/config.d.ts +6 -5
  259. package/lib/projects/config.js +7 -38
  260. package/lib/projects/create/index.js +2 -2
  261. package/lib/projects/create/legacy.js +2 -2
  262. package/lib/projects/create/tracking.d.ts +1 -0
  263. package/lib/projects/create/tracking.js +27 -0
  264. package/lib/projects/create/v2.js +4 -4
  265. package/lib/projects/delete.d.ts +13 -0
  266. package/lib/projects/delete.js +206 -0
  267. package/lib/projects/deploy.d.ts +1 -1
  268. package/lib/projects/deploy.js +2 -2
  269. package/lib/projects/installApp.d.ts +58 -0
  270. package/lib/projects/installApp.js +283 -0
  271. package/lib/projects/localDev/AppDevModeInterface.d.ts +0 -3
  272. package/lib/projects/localDev/AppDevModeInterface.js +33 -55
  273. package/lib/projects/localDev/DevSessionManager.d.ts +8 -5
  274. package/lib/projects/localDev/DevSessionManager.js +35 -49
  275. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  276. package/lib/projects/localDev/LocalDevLogger.js +18 -0
  277. package/lib/projects/localDev/LocalDevProcess.d.ts +11 -1
  278. package/lib/projects/localDev/LocalDevProcess.js +104 -19
  279. package/lib/projects/localDev/LocalDevState.d.ts +9 -2
  280. package/lib/projects/localDev/LocalDevState.js +21 -1
  281. package/lib/projects/localDev/LocalDevWatcher.js +2 -2
  282. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +1 -0
  283. package/lib/projects/localDev/LocalDevWebsocketServer.js +24 -2
  284. package/lib/projects/localDev/UIExtensionsDevModeInterface.js +2 -0
  285. package/lib/projects/localDev/helpers/account.d.ts +1 -7
  286. package/lib/projects/localDev/helpers/account.js +8 -90
  287. package/lib/projects/localDev/helpers/process.d.ts +1 -1
  288. package/lib/projects/localDev/helpers/process.js +4 -10
  289. package/lib/projects/localDev/helpers/project.d.ts +8 -6
  290. package/lib/projects/localDev/helpers/project.js +80 -29
  291. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +2 -1
  292. package/lib/projects/localDev/localDevWebsocketServerUtils.js +3 -0
  293. package/lib/projects/npmAuditOnUpload.d.ts +10 -0
  294. package/lib/projects/npmAuditOnUpload.js +73 -0
  295. package/lib/projects/pollProjectBuildAndDeploy.d.ts +5 -1
  296. package/lib/projects/pollProjectBuildAndDeploy.js +3 -2
  297. package/lib/projects/preview.d.ts +7 -0
  298. package/lib/projects/preview.js +48 -0
  299. package/lib/projects/projectInfo.d.ts +5 -0
  300. package/lib/projects/projectInfo.js +82 -0
  301. package/lib/projects/projectProfiles.d.ts +3 -3
  302. package/lib/projects/projectProfiles.js +11 -18
  303. package/lib/projects/release.d.ts +4 -0
  304. package/lib/projects/release.js +90 -0
  305. package/lib/projects/ui.d.ts +1 -0
  306. package/lib/projects/ui.js +14 -0
  307. package/lib/projects/uieLinting.d.ts +23 -3
  308. package/lib/projects/uieLinting.js +134 -28
  309. package/lib/projects/upload.d.ts +17 -3
  310. package/lib/projects/upload.js +65 -14
  311. package/lib/projects/urls.d.ts +0 -1
  312. package/lib/projects/urls.js +6 -13
  313. package/lib/projects/validate.d.ts +18 -0
  314. package/lib/projects/validate.js +142 -0
  315. package/lib/projects/validateLintConfigOnUpload.d.ts +9 -0
  316. package/lib/projects/validateLintConfigOnUpload.js +46 -0
  317. package/lib/projects/workspaces.d.ts +60 -0
  318. package/lib/projects/workspaces.js +404 -0
  319. package/lib/prompts/createApiSamplePrompt.js +4 -0
  320. package/lib/prompts/personalAccessKeyPrompt.d.ts +2 -5
  321. package/lib/prompts/personalAccessKeyPrompt.js +7 -5
  322. package/lib/prompts/projectDevTargetAccountPrompt.d.ts +1 -0
  323. package/lib/prompts/projectDevTargetAccountPrompt.js +13 -2
  324. package/lib/prompts/projectProfilePrompt.d.ts +9 -0
  325. package/lib/prompts/projectProfilePrompt.js +46 -0
  326. package/lib/prompts/projectsLogsPrompt.js +3 -0
  327. package/lib/prompts/promptUtils.js +4 -2
  328. package/lib/prompts/selectAppPrompt.js +1 -0
  329. package/lib/prompts/selectHubDBTablePrompt.js +2 -2
  330. package/lib/prompts/selectPublicAppForMigrationPrompt.js +2 -2
  331. package/lib/prompts/setAsDefaultAccountPrompt.js +2 -1
  332. package/lib/serverlessLogs.js +2 -2
  333. package/lib/testUtils.d.ts +6 -0
  334. package/lib/testUtils.js +38 -0
  335. package/lib/theme/cmsDevServerProcess.d.ts +2 -0
  336. package/lib/theme/cmsDevServerProcess.js +8 -7
  337. package/lib/theme/migrate.js +1 -4
  338. package/lib/ui/SpinniesManager.d.ts +2 -0
  339. package/lib/ui/SpinniesManager.js +34 -10
  340. package/lib/ui/accountTable.d.ts +8 -0
  341. package/lib/ui/accountTable.js +67 -0
  342. package/lib/ui/appLogs.d.ts +32 -0
  343. package/lib/ui/appLogs.js +175 -0
  344. package/lib/ui/index.js +13 -3
  345. package/lib/ui/spinniesUtils.d.ts +0 -1
  346. package/lib/ui/spinniesUtils.js +6 -16
  347. package/lib/ui/supportsColor.d.ts +4 -0
  348. package/lib/ui/supportsColor.js +25 -6
  349. package/lib/ui/uiMessages.d.ts +1 -0
  350. package/lib/ui/uiMessages.js +1 -0
  351. package/lib/usageTracking.d.ts +10 -20
  352. package/lib/usageTracking.js +77 -30
  353. package/lib/yargs/makeWrappedYargsHandler.d.ts +7 -0
  354. package/lib/yargs/makeWrappedYargsHandler.js +179 -0
  355. package/lib/yargs/makeYargsBuilder.d.ts +13 -0
  356. package/lib/yargs/makeYargsBuilder.js +33 -0
  357. package/lib/yargs/parseYargsOrExit.d.ts +4 -0
  358. package/lib/yargs/parseYargsOrExit.js +25 -0
  359. package/lib/yargs/strictEnforceBoolean.d.ts +1 -0
  360. package/lib/yargs/strictEnforceBoolean.js +13 -0
  361. package/lib/yargsUtils.d.ts +3 -16
  362. package/lib/yargsUtils.js +3 -48
  363. package/mcp-server/Tool.d.ts +25 -0
  364. package/mcp-server/Tool.js +83 -0
  365. package/mcp-server/server.js +69 -3
  366. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +5 -3
  367. package/mcp-server/tools/cms/HsCreateFunctionTool.js +18 -23
  368. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +5 -3
  369. package/mcp-server/tools/cms/HsCreateModuleTool.js +21 -26
  370. package/mcp-server/tools/cms/HsCreateTemplateTool.d.ts +5 -3
  371. package/mcp-server/tools/cms/HsCreateTemplateTool.js +16 -16
  372. package/mcp-server/tools/cms/HsFunctionLogsTool.d.ts +6 -4
  373. package/mcp-server/tools/cms/HsFunctionLogsTool.js +75 -20
  374. package/mcp-server/tools/cms/HsListFunctionsTool.d.ts +5 -3
  375. package/mcp-server/tools/cms/HsListFunctionsTool.js +15 -14
  376. package/mcp-server/tools/cms/HsListTool.d.ts +5 -3
  377. package/mcp-server/tools/cms/HsListTool.js +14 -16
  378. package/mcp-server/tools/index.d.ts +3 -2
  379. package/mcp-server/tools/index.js +28 -22
  380. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +8 -5
  381. package/mcp-server/tools/project/AddFeatureToProjectTool.js +38 -37
  382. package/mcp-server/tools/project/AuthAccountTool.d.ts +19 -0
  383. package/mcp-server/tools/project/AuthAccountTool.js +109 -0
  384. package/mcp-server/tools/project/CreateProjectTool.d.ts +8 -5
  385. package/mcp-server/tools/project/CreateProjectTool.js +33 -20
  386. package/mcp-server/tools/project/CreateTestAccountTool.d.ts +5 -3
  387. package/mcp-server/tools/project/CreateTestAccountTool.js +42 -31
  388. package/mcp-server/tools/project/DeployProjectTool.d.ts +6 -4
  389. package/mcp-server/tools/project/DeployProjectTool.js +44 -28
  390. package/mcp-server/tools/project/DocFetchTool.d.ts +5 -3
  391. package/mcp-server/tools/project/DocFetchTool.js +9 -7
  392. package/mcp-server/tools/project/DocsSearchTool.d.ts +12 -3
  393. package/mcp-server/tools/project/DocsSearchTool.js +50 -17
  394. package/mcp-server/tools/project/FindProjectsTool.d.ts +15 -0
  395. package/mcp-server/tools/project/FindProjectsTool.js +72 -0
  396. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +8 -4
  397. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +48 -17
  398. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +7 -3
  399. package/mcp-server/tools/project/GetApplicationInfoTool.js +26 -22
  400. package/mcp-server/tools/project/GetBuildLogsTool.d.ts +6 -3
  401. package/mcp-server/tools/project/GetBuildLogsTool.js +25 -17
  402. package/mcp-server/tools/project/GetBuildStatusTool.d.ts +6 -3
  403. package/mcp-server/tools/project/GetBuildStatusTool.js +25 -17
  404. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +7 -3
  405. package/mcp-server/tools/project/GetConfigValuesTool.js +25 -15
  406. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +5 -3
  407. package/mcp-server/tools/project/GuidedWalkthroughTool.js +4 -6
  408. package/mcp-server/tools/project/KnowledgeSearchTool.d.ts +29 -0
  409. package/mcp-server/tools/project/KnowledgeSearchTool.js +82 -0
  410. package/mcp-server/tools/project/UploadProjectTools.d.ts +6 -4
  411. package/mcp-server/tools/project/UploadProjectTools.js +63 -42
  412. package/mcp-server/tools/project/ValidateProjectTool.d.ts +5 -3
  413. package/mcp-server/tools/project/ValidateProjectTool.js +32 -13
  414. package/mcp-server/tools/project/apps.d.ts +8 -0
  415. package/mcp-server/tools/project/apps.js +7 -0
  416. package/mcp-server/tools/project/constants.d.ts +6 -2
  417. package/mcp-server/tools/project/constants.js +12 -1
  418. package/mcp-server/tools/project/productionConfirmation.d.ts +12 -0
  419. package/mcp-server/tools/project/productionConfirmation.js +45 -0
  420. package/mcp-server/tools/project/resolveAccount.d.ts +15 -0
  421. package/mcp-server/tools/project/resolveAccount.js +60 -0
  422. package/mcp-server/types.d.ts +3 -8
  423. package/mcp-server/types.js +1 -13
  424. package/mcp-server/utils/command.d.ts +26 -2
  425. package/mcp-server/utils/command.js +75 -15
  426. package/mcp-server/utils/config.js +6 -0
  427. package/mcp-server/utils/content.d.ts +3 -2
  428. package/mcp-server/utils/content.js +6 -1
  429. package/mcp-server/utils/elicitSelection.d.ts +11 -0
  430. package/mcp-server/utils/elicitSelection.js +25 -0
  431. package/mcp-server/utils/elicitation.d.ts +11 -0
  432. package/mcp-server/utils/elicitation.js +38 -0
  433. package/mcp-server/utils/json.d.ts +3 -0
  434. package/mcp-server/utils/json.js +29 -0
  435. package/mcp-server/utils/logger.d.ts +13 -0
  436. package/mcp-server/utils/logger.js +59 -0
  437. package/mcp-server/utils/toolUsageTracking.js +28 -11
  438. package/package.json +37 -28
  439. package/types/AccountTargets.d.ts +37 -0
  440. package/types/AccountTargets.js +12 -0
  441. package/types/Link.d.ts +32 -0
  442. package/types/Link.js +5 -0
  443. package/types/LocalDev.d.ts +15 -2
  444. package/types/PackageJson.d.ts +1 -0
  445. package/types/ProjectComponents.d.ts +2 -1
  446. package/types/Projects.d.ts +25 -5
  447. package/types/Prompts.d.ts +1 -0
  448. package/types/Yargs.d.ts +23 -2
  449. package/ui/components/ActionSection.d.ts +1 -1
  450. package/ui/components/InputField.d.ts +1 -1
  451. package/ui/components/SelectInput.d.ts +1 -1
  452. package/ui/components/StatusIcon.d.ts +1 -1
  453. package/ui/components/Table.d.ts +13 -13
  454. package/ui/components/getStarted/GetStartedFlow.d.ts +1 -1
  455. package/ui/components/getStarted/screens/InstallationScreen.d.ts +1 -1
  456. package/ui/components/getStarted/screens/ProjectSetupScreen.d.ts +1 -1
  457. package/ui/components/getStarted/screens/UploadScreen.d.ts +1 -1
  458. package/api/__tests__/migrate.test.d.ts +0 -1
  459. package/api/__tests__/migrate.test.js +0 -199
  460. package/commands/__tests__/account.test.d.ts +0 -1
  461. package/commands/__tests__/account.test.js +0 -69
  462. package/commands/__tests__/auth.test.d.ts +0 -1
  463. package/commands/__tests__/auth.test.js +0 -43
  464. package/commands/__tests__/cms.test.d.ts +0 -1
  465. package/commands/__tests__/cms.test.js +0 -87
  466. package/commands/__tests__/config.test.d.ts +0 -1
  467. package/commands/__tests__/config.test.js +0 -44
  468. package/commands/__tests__/customObject.test.d.ts +0 -1
  469. package/commands/__tests__/customObject.test.js +0 -68
  470. package/commands/__tests__/doctor.test.d.ts +0 -1
  471. package/commands/__tests__/doctor.test.js +0 -132
  472. package/commands/__tests__/feedback.test.d.ts +0 -1
  473. package/commands/__tests__/feedback.test.js +0 -24
  474. package/commands/__tests__/filemanager.test.d.ts +0 -1
  475. package/commands/__tests__/filemanager.test.js +0 -45
  476. package/commands/__tests__/getStarted.test.d.ts +0 -1
  477. package/commands/__tests__/getStarted.test.js +0 -173
  478. package/commands/__tests__/hubdb.test.d.ts +0 -1
  479. package/commands/__tests__/hubdb.test.js +0 -50
  480. package/commands/__tests__/init.test.d.ts +0 -1
  481. package/commands/__tests__/init.test.js +0 -42
  482. package/commands/__tests__/mcp.test.d.ts +0 -1
  483. package/commands/__tests__/mcp.test.js +0 -46
  484. package/commands/__tests__/open.test.d.ts +0 -1
  485. package/commands/__tests__/open.test.js +0 -58
  486. package/commands/__tests__/project.test.d.ts +0 -1
  487. package/commands/__tests__/project.test.js +0 -125
  488. package/commands/__tests__/sandbox.test.d.ts +0 -1
  489. package/commands/__tests__/sandbox.test.js +0 -44
  490. package/commands/__tests__/secret.test.d.ts +0 -1
  491. package/commands/__tests__/secret.test.js +0 -49
  492. package/commands/__tests__/testAccount.test.d.ts +0 -1
  493. package/commands/__tests__/testAccount.test.js +0 -57
  494. package/commands/__tests__/upgrade.test.d.ts +0 -1
  495. package/commands/__tests__/upgrade.test.js +0 -309
  496. package/commands/account/__tests__/auth.test.d.ts +0 -1
  497. package/commands/account/__tests__/auth.test.js +0 -206
  498. package/commands/account/__tests__/clean.test.d.ts +0 -1
  499. package/commands/account/__tests__/clean.test.js +0 -28
  500. package/commands/account/__tests__/createOverride.test.d.ts +0 -1
  501. package/commands/account/__tests__/createOverride.test.js +0 -32
  502. package/commands/account/__tests__/info.test.d.ts +0 -1
  503. package/commands/account/__tests__/info.test.js +0 -28
  504. package/commands/account/__tests__/list.test.d.ts +0 -1
  505. package/commands/account/__tests__/list.test.js +0 -153
  506. package/commands/account/__tests__/remove.test.d.ts +0 -1
  507. package/commands/account/__tests__/remove.test.js +0 -36
  508. package/commands/account/__tests__/removeOverride.d.ts +0 -1
  509. package/commands/account/__tests__/removeOverride.js +0 -25
  510. package/commands/account/__tests__/rename.test.d.ts +0 -1
  511. package/commands/account/__tests__/rename.test.js +0 -82
  512. package/commands/account/__tests__/use.test.d.ts +0 -1
  513. package/commands/account/__tests__/use.test.js +0 -170
  514. package/commands/app/__tests__/migrate.test.d.ts +0 -1
  515. package/commands/app/__tests__/migrate.test.js +0 -111
  516. package/commands/app/secret/__tests__/add.test.d.ts +0 -1
  517. package/commands/app/secret/__tests__/add.test.js +0 -140
  518. package/commands/app/secret/__tests__/delete.test.d.ts +0 -1
  519. package/commands/app/secret/__tests__/delete.test.js +0 -28
  520. package/commands/app/secret/__tests__/list.test.d.ts +0 -1
  521. package/commands/app/secret/__tests__/list.test.js +0 -25
  522. package/commands/app/secret/__tests__/update.test.d.ts +0 -1
  523. package/commands/app/secret/__tests__/update.test.js +0 -28
  524. package/commands/cms/__tests__/delete.test.d.ts +0 -1
  525. package/commands/cms/__tests__/delete.test.js +0 -39
  526. package/commands/cms/__tests__/fetch.test.d.ts +0 -1
  527. package/commands/cms/__tests__/fetch.test.js +0 -156
  528. package/commands/cms/__tests__/function.test.d.ts +0 -1
  529. package/commands/cms/__tests__/function.test.js +0 -50
  530. package/commands/cms/__tests__/lint.test.d.ts +0 -1
  531. package/commands/cms/__tests__/lint.test.js +0 -33
  532. package/commands/cms/__tests__/list.test.d.ts +0 -1
  533. package/commands/cms/__tests__/list.test.js +0 -42
  534. package/commands/cms/__tests__/module.test.d.ts +0 -1
  535. package/commands/cms/__tests__/module.test.js +0 -45
  536. package/commands/cms/__tests__/mv.test.d.ts +0 -1
  537. package/commands/cms/__tests__/mv.test.js +0 -46
  538. package/commands/cms/__tests__/theme.test.d.ts +0 -1
  539. package/commands/cms/__tests__/theme.test.js +0 -54
  540. package/commands/cms/__tests__/upload.test.d.ts +0 -1
  541. package/commands/cms/__tests__/upload.test.js +0 -312
  542. package/commands/cms/__tests__/watch.test.d.ts +0 -1
  543. package/commands/cms/__tests__/watch.test.js +0 -204
  544. package/commands/cms/function/__tests__/logs.test.d.ts +0 -1
  545. package/commands/cms/function/__tests__/logs.test.js +0 -70
  546. package/commands/cms/theme/__tests__/generate-selectors.test.d.ts +0 -1
  547. package/commands/cms/theme/__tests__/generate-selectors.test.js +0 -28
  548. package/commands/cms/theme/__tests__/marketplace-validate.test.d.ts +0 -1
  549. package/commands/cms/theme/__tests__/marketplace-validate.test.js +0 -36
  550. package/commands/cms/theme/__tests__/preview.test.d.ts +0 -1
  551. package/commands/cms/theme/__tests__/preview.test.js +0 -54
  552. package/commands/customObject/__tests__/create.test.d.ts +0 -1
  553. package/commands/customObject/__tests__/create.test.js +0 -40
  554. package/commands/customObject/__tests__/createSchema.test.d.ts +0 -1
  555. package/commands/customObject/__tests__/createSchema.test.js +0 -28
  556. package/commands/customObject/__tests__/deleteSchema.test.d.ts +0 -1
  557. package/commands/customObject/__tests__/deleteSchema.test.js +0 -42
  558. package/commands/customObject/__tests__/fetch-all-schemas.test.d.ts +0 -1
  559. package/commands/customObject/__tests__/fetch-all-schemas.test.js +0 -41
  560. package/commands/customObject/__tests__/fetchSchema.test.d.ts +0 -1
  561. package/commands/customObject/__tests__/fetchSchema.test.js +0 -45
  562. package/commands/customObject/__tests__/listSchemas.test.d.ts +0 -1
  563. package/commands/customObject/__tests__/listSchemas.test.js +0 -29
  564. package/commands/customObject/__tests__/updateSchema.test.d.ts +0 -1
  565. package/commands/customObject/__tests__/updateSchema.test.js +0 -40
  566. package/commands/filemanager/__tests__/fetch.test.d.ts +0 -1
  567. package/commands/filemanager/__tests__/fetch.test.js +0 -32
  568. package/commands/filemanager/__tests__/upload.test.d.ts +0 -1
  569. package/commands/filemanager/__tests__/upload.test.js +0 -191
  570. package/commands/hubdb/__tests__/clear.test.d.ts +0 -1
  571. package/commands/hubdb/__tests__/clear.test.js +0 -28
  572. package/commands/hubdb/__tests__/create.test.d.ts +0 -1
  573. package/commands/hubdb/__tests__/create.test.js +0 -28
  574. package/commands/hubdb/__tests__/delete.test.d.ts +0 -1
  575. package/commands/hubdb/__tests__/delete.test.js +0 -28
  576. package/commands/hubdb/__tests__/fetch.test.d.ts +0 -1
  577. package/commands/hubdb/__tests__/fetch.test.js +0 -28
  578. package/commands/hubdb/__tests__/list.test.d.ts +0 -1
  579. package/commands/hubdb/__tests__/list.test.js +0 -88
  580. package/commands/mcp/__tests__/setup.test.d.ts +0 -1
  581. package/commands/mcp/__tests__/setup.test.js +0 -26
  582. package/commands/mcp/__tests__/start.test.d.ts +0 -1
  583. package/commands/mcp/__tests__/start.test.js +0 -144
  584. package/commands/project/__tests__/add.test.d.ts +0 -1
  585. package/commands/project/__tests__/add.test.js +0 -107
  586. package/commands/project/__tests__/create.test.d.ts +0 -1
  587. package/commands/project/__tests__/create.test.js +0 -97
  588. package/commands/project/__tests__/deploy.test.d.ts +0 -1
  589. package/commands/project/__tests__/deploy.test.js +0 -307
  590. package/commands/project/__tests__/dev.test.d.ts +0 -1
  591. package/commands/project/__tests__/dev.test.js +0 -273
  592. package/commands/project/__tests__/devUnifiedFlow.test.d.ts +0 -1
  593. package/commands/project/__tests__/devUnifiedFlow.test.js +0 -434
  594. package/commands/project/__tests__/download.test.d.ts +0 -1
  595. package/commands/project/__tests__/download.test.js +0 -39
  596. package/commands/project/__tests__/installDeps.test.d.ts +0 -1
  597. package/commands/project/__tests__/installDeps.test.js +0 -140
  598. package/commands/project/__tests__/lint.test.d.ts +0 -1
  599. package/commands/project/__tests__/lint.test.js +0 -704
  600. package/commands/project/__tests__/list.test.d.ts +0 -1
  601. package/commands/project/__tests__/list.test.js +0 -31
  602. package/commands/project/__tests__/listBuilds.test.d.ts +0 -1
  603. package/commands/project/__tests__/listBuilds.test.js +0 -38
  604. package/commands/project/__tests__/logs.test.d.ts +0 -1
  605. package/commands/project/__tests__/logs.test.js +0 -202
  606. package/commands/project/__tests__/migrate.test.d.ts +0 -1
  607. package/commands/project/__tests__/migrate.test.js +0 -106
  608. package/commands/project/__tests__/open.test.d.ts +0 -1
  609. package/commands/project/__tests__/open.test.js +0 -39
  610. package/commands/project/__tests__/profile.test.d.ts +0 -1
  611. package/commands/project/__tests__/profile.test.js +0 -42
  612. package/commands/project/__tests__/updateDeps.test.d.ts +0 -1
  613. package/commands/project/__tests__/updateDeps.test.js +0 -140
  614. package/commands/project/__tests__/upload.test.d.ts +0 -1
  615. package/commands/project/__tests__/upload.test.js +0 -234
  616. package/commands/project/__tests__/validate.test.d.ts +0 -1
  617. package/commands/project/__tests__/validate.test.js +0 -381
  618. package/commands/project/__tests__/watch.test.d.ts +0 -1
  619. package/commands/project/__tests__/watch.test.js +0 -35
  620. package/commands/project/dev/deprecatedFlow.d.ts +0 -11
  621. package/commands/project/dev/deprecatedFlow.js +0 -135
  622. package/commands/sandbox/__tests__/create.test.d.ts +0 -1
  623. package/commands/sandbox/__tests__/create.test.js +0 -198
  624. package/commands/sandbox/__tests__/delete.test.d.ts +0 -1
  625. package/commands/sandbox/__tests__/delete.test.js +0 -31
  626. package/commands/secret/__tests__/addSecret.test.d.ts +0 -1
  627. package/commands/secret/__tests__/addSecret.test.js +0 -162
  628. package/commands/secret/__tests__/deleteSecret.test.d.ts +0 -1
  629. package/commands/secret/__tests__/deleteSecret.test.js +0 -41
  630. package/commands/secret/__tests__/listSecret.test.d.ts +0 -1
  631. package/commands/secret/__tests__/listSecret.test.js +0 -29
  632. package/commands/secret/__tests__/updateSecret.test.d.ts +0 -1
  633. package/commands/secret/__tests__/updateSecret.test.js +0 -29
  634. package/commands/testAccount/__tests__/create.test.d.ts +0 -1
  635. package/commands/testAccount/__tests__/create.test.js +0 -106
  636. package/commands/testAccount/__tests__/createConfig.test.d.ts +0 -1
  637. package/commands/testAccount/__tests__/createConfig.test.js +0 -32
  638. package/commands/testAccount/__tests__/delete.test.d.ts +0 -1
  639. package/commands/testAccount/__tests__/delete.test.js +0 -29
  640. package/commands/testAccount/__tests__/importData.test.d.ts +0 -1
  641. package/commands/testAccount/__tests__/importData.test.js +0 -92
  642. package/lib/__tests__/CLIWebSocketServer.test.d.ts +0 -1
  643. package/lib/__tests__/CLIWebSocketServer.test.js +0 -252
  644. package/lib/__tests__/accountAuth.test.d.ts +0 -1
  645. package/lib/__tests__/accountAuth.test.js +0 -258
  646. package/lib/__tests__/accountTypes.test.d.ts +0 -1
  647. package/lib/__tests__/accountTypes.test.js +0 -98
  648. package/lib/__tests__/buildAccount.test.d.ts +0 -1
  649. package/lib/__tests__/buildAccount.test.js +0 -211
  650. package/lib/__tests__/cliUpgradeUtils.test.d.ts +0 -1
  651. package/lib/__tests__/cliUpgradeUtils.test.js +0 -131
  652. package/lib/__tests__/commandSuggestion.test.d.ts +0 -1
  653. package/lib/__tests__/commandSuggestion.test.js +0 -121
  654. package/lib/__tests__/commonOpts.test.d.ts +0 -1
  655. package/lib/__tests__/commonOpts.test.js +0 -80
  656. package/lib/__tests__/dependencyManagement.test.d.ts +0 -1
  657. package/lib/__tests__/dependencyManagement.test.js +0 -1067
  658. package/lib/__tests__/developerTestAccounts.test.d.ts +0 -1
  659. package/lib/__tests__/developerTestAccounts.test.js +0 -156
  660. package/lib/__tests__/hasFeature.test.d.ts +0 -1
  661. package/lib/__tests__/hasFeature.test.js +0 -167
  662. package/lib/__tests__/http.test.d.ts +0 -1
  663. package/lib/__tests__/http.test.js +0 -40
  664. package/lib/__tests__/importData.test.d.ts +0 -1
  665. package/lib/__tests__/importData.test.js +0 -98
  666. package/lib/__tests__/npmCli.test.d.ts +0 -1
  667. package/lib/__tests__/npmCli.test.js +0 -84
  668. package/lib/__tests__/oauth.test.d.ts +0 -1
  669. package/lib/__tests__/oauth.test.js +0 -109
  670. package/lib/__tests__/parsing.test.d.ts +0 -1
  671. package/lib/__tests__/parsing.test.js +0 -34
  672. package/lib/__tests__/polling.test.d.ts +0 -1
  673. package/lib/__tests__/polling.test.js +0 -76
  674. package/lib/__tests__/process.test.d.ts +0 -1
  675. package/lib/__tests__/process.test.js +0 -89
  676. package/lib/__tests__/sandboxes.test.d.ts +0 -1
  677. package/lib/__tests__/sandboxes.test.js +0 -128
  678. package/lib/__tests__/serverlessLogs.test.d.ts +0 -1
  679. package/lib/__tests__/serverlessLogs.test.js +0 -163
  680. package/lib/__tests__/usageTracking.test.d.ts +0 -1
  681. package/lib/__tests__/usageTracking.test.js +0 -197
  682. package/lib/__tests__/validation.test.d.ts +0 -1
  683. package/lib/__tests__/validation.test.js +0 -143
  684. package/lib/__tests__/yargsUtils.test.d.ts +0 -1
  685. package/lib/__tests__/yargsUtils.test.js +0 -124
  686. package/lib/app/__tests__/migrate.test.d.ts +0 -1
  687. package/lib/app/__tests__/migrate.test.js +0 -638
  688. package/lib/doctor/__tests__/Diagnosis.test.d.ts +0 -1
  689. package/lib/doctor/__tests__/Diagnosis.test.js +0 -84
  690. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.d.ts +0 -1
  691. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js +0 -177
  692. package/lib/doctor/__tests__/Doctor.test.d.ts +0 -1
  693. package/lib/doctor/__tests__/Doctor.test.js +0 -560
  694. package/lib/errorHandlers/__tests__/index.test.d.ts +0 -1
  695. package/lib/errorHandlers/__tests__/index.test.js +0 -278
  696. package/lib/mcp/__tests__/setup.test.d.ts +0 -1
  697. package/lib/mcp/__tests__/setup.test.js +0 -523
  698. package/lib/middleware/__tests__/commandTargetingUtils.test.d.ts +0 -1
  699. package/lib/middleware/__tests__/commandTargetingUtils.test.js +0 -99
  700. package/lib/middleware/__tests__/configMiddleware.test.d.ts +0 -1
  701. package/lib/middleware/__tests__/configMiddleware.test.js +0 -118
  702. package/lib/middleware/__tests__/gitMiddleware.test.d.ts +0 -1
  703. package/lib/middleware/__tests__/gitMiddleware.test.js +0 -43
  704. package/lib/middleware/__tests__/requestMiddleware.test.d.ts +0 -1
  705. package/lib/middleware/__tests__/requestMiddleware.test.js +0 -15
  706. package/lib/middleware/__tests__/usageTrackingMiddleware.test.d.ts +0 -1
  707. package/lib/middleware/__tests__/usageTrackingMiddleware.test.js +0 -44
  708. package/lib/middleware/__tests__/yargsChecksMiddleware.test.d.ts +0 -1
  709. package/lib/middleware/__tests__/yargsChecksMiddleware.test.js +0 -39
  710. package/lib/projects/__tests__/AppDevModeInterface.test.d.ts +0 -1
  711. package/lib/projects/__tests__/AppDevModeInterface.test.js +0 -541
  712. package/lib/projects/__tests__/DevServerManager.test.d.ts +0 -1
  713. package/lib/projects/__tests__/DevServerManager.test.js +0 -185
  714. package/lib/projects/__tests__/DevSessionManager.test.d.ts +0 -1
  715. package/lib/projects/__tests__/DevSessionManager.test.js +0 -250
  716. package/lib/projects/__tests__/LocalDevProcess.test.d.ts +0 -1
  717. package/lib/projects/__tests__/LocalDevProcess.test.js +0 -481
  718. package/lib/projects/__tests__/LocalDevWebsocketServer.test.d.ts +0 -1
  719. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +0 -231
  720. package/lib/projects/__tests__/ProjectLogsManager.test.d.ts +0 -1
  721. package/lib/projects/__tests__/ProjectLogsManager.test.js +0 -302
  722. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.d.ts +0 -1
  723. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.js +0 -160
  724. package/lib/projects/__tests__/components.test.d.ts +0 -1
  725. package/lib/projects/__tests__/components.test.js +0 -440
  726. package/lib/projects/__tests__/deploy.test.d.ts +0 -1
  727. package/lib/projects/__tests__/deploy.test.js +0 -231
  728. package/lib/projects/__tests__/localDevProjectHelpers.test.d.ts +0 -1
  729. package/lib/projects/__tests__/localDevProjectHelpers.test.js +0 -120
  730. package/lib/projects/__tests__/platformVersion.test.d.ts +0 -1
  731. package/lib/projects/__tests__/platformVersion.test.js +0 -63
  732. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.d.ts +0 -1
  733. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.js +0 -328
  734. package/lib/projects/__tests__/projectProfiles.test.d.ts +0 -1
  735. package/lib/projects/__tests__/projectProfiles.test.js +0 -441
  736. package/lib/projects/__tests__/projects.test.d.ts +0 -1
  737. package/lib/projects/__tests__/projects.test.js +0 -58
  738. package/lib/projects/__tests__/structure.test.d.ts +0 -1
  739. package/lib/projects/__tests__/structure.test.js +0 -210
  740. package/lib/projects/__tests__/uieLinting.test.d.ts +0 -1
  741. package/lib/projects/__tests__/uieLinting.test.js +0 -631
  742. package/lib/projects/__tests__/upload.test.d.ts +0 -1
  743. package/lib/projects/__tests__/upload.test.js +0 -183
  744. package/lib/projects/add/__tests__/legacyAddComponent.test.d.ts +0 -1
  745. package/lib/projects/add/__tests__/legacyAddComponent.test.js +0 -245
  746. package/lib/projects/add/__tests__/v2AddComponent.test.d.ts +0 -1
  747. package/lib/projects/add/__tests__/v2AddComponent.test.js +0 -343
  748. package/lib/projects/create/__tests__/legacy.test.d.ts +0 -1
  749. package/lib/projects/create/__tests__/legacy.test.js +0 -72
  750. package/lib/projects/create/__tests__/v2.test.d.ts +0 -1
  751. package/lib/projects/create/__tests__/v2.test.js +0 -257
  752. package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts +0 -40
  753. package/lib/projects/localDev/DevServerManager_DEPRECATED.js +0 -128
  754. package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts +0 -59
  755. package/lib/projects/localDev/LocalDevManager_DEPRECATED.js +0 -387
  756. package/lib/projects/platformVersion.d.ts +0 -9
  757. package/lib/projects/platformVersion.js +0 -39
  758. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.d.ts +0 -1
  759. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.js +0 -157
  760. package/lib/prompts/__tests__/createFunctionPrompt.test.d.ts +0 -1
  761. package/lib/prompts/__tests__/createFunctionPrompt.test.js +0 -129
  762. package/lib/prompts/__tests__/createModulePrompt.test.d.ts +0 -1
  763. package/lib/prompts/__tests__/createModulePrompt.test.js +0 -187
  764. package/lib/prompts/__tests__/createTemplatePrompt.test.d.ts +0 -1
  765. package/lib/prompts/__tests__/createTemplatePrompt.test.js +0 -102
  766. package/lib/prompts/__tests__/downloadProjectPrompt.test.d.ts +0 -1
  767. package/lib/prompts/__tests__/downloadProjectPrompt.test.js +0 -31
  768. package/lib/prompts/__tests__/projectAddPrompt.test.d.ts +0 -1
  769. package/lib/prompts/__tests__/projectAddPrompt.test.js +0 -143
  770. package/lib/prompts/__tests__/projectsLogsPrompt.test.d.ts +0 -1
  771. package/lib/prompts/__tests__/projectsLogsPrompt.test.js +0 -37
  772. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.d.ts +0 -1
  773. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.js +0 -160
  774. package/lib/theme/__tests__/migrate.test.d.ts +0 -1
  775. package/lib/theme/__tests__/migrate.test.js +0 -247
  776. package/lib/ui/__tests__/SpinniesManager.test.d.ts +0 -1
  777. package/lib/ui/__tests__/SpinniesManager.test.js +0 -488
  778. package/lib/ui/__tests__/removeAnsiCodes.test.d.ts +0 -1
  779. package/lib/ui/__tests__/removeAnsiCodes.test.js +0 -84
  780. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.d.ts +0 -1
  781. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.js +0 -254
  782. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.d.ts +0 -1
  783. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.js +0 -227
  784. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.d.ts +0 -1
  785. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.js +0 -208
  786. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.d.ts +0 -1
  787. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js +0 -186
  788. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.d.ts +0 -1
  789. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.js +0 -124
  790. package/mcp-server/tools/cms/__tests__/HsListTool.test.d.ts +0 -1
  791. package/mcp-server/tools/cms/__tests__/HsListTool.test.js +0 -124
  792. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.d.ts +0 -1
  793. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js +0 -157
  794. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.d.ts +0 -1
  795. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js +0 -131
  796. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.d.ts +0 -1
  797. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.js +0 -461
  798. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.d.ts +0 -1
  799. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js +0 -125
  800. package/mcp-server/tools/project/__tests__/DocFetchTool.test.d.ts +0 -1
  801. package/mcp-server/tools/project/__tests__/DocFetchTool.test.js +0 -125
  802. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.d.ts +0 -1
  803. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +0 -210
  804. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +0 -1
  805. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +0 -146
  806. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +0 -1
  807. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +0 -124
  808. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.d.ts +0 -1
  809. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.js +0 -307
  810. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.d.ts +0 -1
  811. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.js +0 -242
  812. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.d.ts +0 -1
  813. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +0 -209
  814. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.d.ts +0 -1
  815. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.js +0 -158
  816. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.d.ts +0 -1
  817. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.js +0 -187
  818. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.d.ts +0 -1
  819. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.js +0 -118
  820. package/mcp-server/utils/__tests__/command.test.d.ts +0 -1
  821. package/mcp-server/utils/__tests__/command.test.js +0 -275
  822. package/mcp-server/utils/__tests__/content.test.d.ts +0 -1
  823. package/mcp-server/utils/__tests__/content.test.js +0 -164
  824. package/mcp-server/utils/__tests__/feedbackTracking.test.d.ts +0 -1
  825. package/mcp-server/utils/__tests__/feedbackTracking.test.js +0 -69
@@ -1,17 +1,20 @@
1
- import { Tool } from '../../types.js';
1
+ import { Tool } from '../../Tool.js';
2
2
  import { z } from 'zod';
3
- import { addFlag } from '../../utils/command.js';
4
- import { absoluteCurrentWorkingDirectory, absoluteProjectPath, } from './constants.js';
5
- import { runCommandInDir } from '../../utils/command.js';
6
- import { formatTextContents, formatTextContent } from '../../utils/content.js';
7
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
3
+ import { HubSpotCommand } from '../../utils/command.js';
4
+ import { absoluteProjectPath, confirmProductionAccount } from './constants.js';
5
+ import { formatErrorTextContents, formatTextContents, } from '../../utils/content.js';
8
6
  import { setupHubSpotConfig } from '../../utils/config.js';
7
+ import { parseCommandJsonOutput } from '../../utils/json.js';
8
+ import { ProjectDeploySchema } from '../../../lib/jsonOutput/projectDeploy.js';
9
+ import { getProjectConfig } from '../../../lib/projects/config.js';
10
+ import { discoverAccountTargets } from '../../../lib/accountTargetDiscovery.js';
11
+ import { confirmProductionTargets, setTargetAccount, } from './productionConfirmation.js';
9
12
  const inputSchema = {
10
13
  absoluteProjectPath,
11
- absoluteCurrentWorkingDirectory,
12
14
  buildNumber: z
13
15
  .optional(z.number())
14
- .describe('The build number to be deployed. This can be found in the project details page using `hs project open`. If no build number is specified, the most recent build is deployed'),
16
+ .describe('The build number to deploy. This can be found in the project details page using `hs project open`. If omitted, the tool deploys nothing and returns the recent builds, so you can ask the user which one to deploy.'),
17
+ confirmProductionAccount,
15
18
  };
16
19
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
17
20
  const inputSchemaZodObject = z.object({
@@ -19,40 +22,53 @@ const inputSchemaZodObject = z.object({
19
22
  });
20
23
  const toolName = 'deploy-project';
21
24
  export class DeployProjectTool extends Tool {
22
- constructor(mcpServer) {
23
- super(mcpServer);
25
+ constructor(mcpServer, logger) {
26
+ super(mcpServer, logger, toolName);
24
27
  }
25
- async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, buildNumber, }) {
26
- setupHubSpotConfig(absoluteCurrentWorkingDirectory);
27
- await trackToolUsage(toolName);
28
- let command = `hs project deploy`;
29
- const content = [];
28
+ async handler({ absoluteProjectPath, buildNumber, confirmProductionAccount, }, extra) {
29
+ setupHubSpotConfig(absoluteProjectPath);
30
+ const { projectDir, projectConfig } = getProjectConfig(absoluteProjectPath);
31
+ const targets = await discoverAccountTargets({ projectDir, projectConfig });
30
32
  if (!buildNumber) {
31
- const { stdout } = await runCommandInDir(absoluteProjectPath, `hs project list-builds --limit 100`);
32
- content.push(formatTextContent(`Ask the user which build number they would like to deploy? Build information: ${stdout}`));
33
+ const listBuildsCommand = new HubSpotCommand('project list-builds', [
34
+ { name: 'limit', value: 100 },
35
+ ]);
36
+ setTargetAccount(listBuildsCommand, targets);
37
+ const { stdout } = await this.runCommand(absoluteProjectPath, listBuildsCommand, extra);
38
+ return formatErrorTextContents(`Ask the user which build number they would like to deploy? Build information: ${stdout}`);
33
39
  }
34
- else {
35
- command = addFlag(command, 'build', buildNumber);
40
+ const blockedResponse = await confirmProductionTargets(this.mcpServer, this.logger, {
41
+ targets,
42
+ action: `Deploy build #${buildNumber}`,
43
+ toolName,
44
+ confirmedInConversation: confirmProductionAccount,
45
+ });
46
+ if (blockedResponse) {
47
+ return blockedResponse;
36
48
  }
37
- if (content.length) {
38
- return {
39
- content,
40
- };
41
- }
42
- const { stdout, stderr } = await runCommandInDir(absoluteProjectPath, command);
43
- return formatTextContents(stdout, stderr);
49
+ const command = new HubSpotCommand('project deploy', [
50
+ { name: 'build', value: buildNumber },
51
+ { name: 'json', value: true },
52
+ ]);
53
+ setTargetAccount(command, targets);
54
+ const { stdout, stderr } = await this.runCommand(absoluteProjectPath, command, extra);
55
+ const response = await formatTextContents(stdout, stderr);
56
+ response.structuredContent =
57
+ parseCommandJsonOutput(stdout, ProjectDeploySchema, this.logger, toolName) ?? {};
58
+ return response;
44
59
  }
45
60
  register() {
46
61
  return this.mcpServer.registerTool(toolName, {
47
62
  title: 'Deploy a build of HubSpot Project',
48
- description: 'Takes a build number and a project name and deploys that build of the project. DO NOT run this tool unless the user specifies they would like to deploy the project.',
63
+ description: 'Takes a build number and a project name and deploys that build of the project. DO NOT run this tool unless the user specifies they would like to deploy the project. Deploys to production accounts require confirmation from the user. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
49
64
  inputSchema,
65
+ outputSchema: ProjectDeploySchema.shape,
50
66
  annotations: {
51
67
  readOnlyHint: false,
52
68
  destructiveHint: true,
53
69
  idempotentHint: true,
54
70
  openWorldHint: true,
55
71
  },
56
- }, this.handler);
72
+ }, (input, extra) => this.wrappedHandler(input, extra));
57
73
  }
58
74
  }
@@ -1,14 +1,16 @@
1
1
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { McpLogger } from '../../utils/logger.js';
2
3
  import z from 'zod';
3
- import { TextContentResponse, Tool } from '../../types.js';
4
+ import { McpToolResponse } from '../../types.js';
5
+ import { Tool } from '../../Tool.js';
4
6
  declare const inputSchemaZodObject: z.ZodObject<{
5
7
  docUrl: z.ZodString;
6
8
  absoluteCurrentWorkingDirectory: z.ZodString;
7
9
  }, z.z.core.$strip>;
8
10
  type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
9
11
  export declare class DocFetchTool extends Tool<InputSchemaType> {
10
- constructor(mcpServer: McpServer);
11
- handler({ docUrl, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<TextContentResponse>;
12
+ constructor(mcpServer: McpServer, logger: McpLogger);
13
+ handler({ docUrl, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<McpToolResponse>;
12
14
  register(): RegisteredTool;
13
15
  }
14
16
  export {};
@@ -1,7 +1,6 @@
1
1
  import z from 'zod';
2
- import { Tool } from '../../types.js';
2
+ import { Tool } from '../../Tool.js';
3
3
  import { formatTextContents } from '../../utils/content.js';
4
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
5
4
  import { absoluteCurrentWorkingDirectory, docUrl } from './constants.js';
6
5
  import { http } from '@hubspot/local-dev-lib/http/unauthed';
7
6
  import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
@@ -17,12 +16,11 @@ const inputSchemaZodObject = z.object({
17
16
  });
18
17
  const toolName = 'fetch-doc';
19
18
  export class DocFetchTool extends Tool {
20
- constructor(mcpServer) {
21
- super(mcpServer);
19
+ constructor(mcpServer, logger) {
20
+ super(mcpServer, logger, toolName);
22
21
  }
23
22
  async handler({ docUrl, absoluteCurrentWorkingDirectory, }) {
24
23
  setupHubSpotConfig(absoluteCurrentWorkingDirectory);
25
- await trackToolUsage(toolName);
26
24
  try {
27
25
  // Append .md extension to the URL
28
26
  const markdownUrl = `${docUrl}.md`;
@@ -36,6 +34,10 @@ export class DocFetchTool extends Tool {
36
34
  return formatTextContents(content);
37
35
  }
38
36
  catch (error) {
37
+ this.logger.debug(toolName, {
38
+ message: 'Handler caught error',
39
+ error: error instanceof Error ? error.message : String(error),
40
+ });
39
41
  if (isHubSpotHttpError(error)) {
40
42
  return formatTextContents(error.toString());
41
43
  }
@@ -46,12 +48,12 @@ export class DocFetchTool extends Tool {
46
48
  register() {
47
49
  return this.mcpServer.registerTool(toolName, {
48
50
  title: 'Fetch HubSpot Developer Documentation (single file)',
49
- description: 'Always use this immediately after `search-docs` and before creating a plan, writing code, or answering technical questions. This tool retrieves the full, authoritative content of a HubSpot Developer Documentation page from its URL, ensuring responses are accurate, up-to-date, and grounded in the official docs.',
51
+ description: 'Always use this immediately after `search-docs` and before creating a plan, writing code, or answering technical questions. This tool retrieves the full, authoritative content of a HubSpot Developer Documentation page from its URL, ensuring responses are accurate, up-to-date, and grounded in the official docs. Some pages include a "Supported products" section (a `<SupportedProducts .../>` tag) listing the products and subscription tiers a feature requires. Read it to tell the user whether a feature is available on their plan, stated plainly (for example "requires Content Hub Enterprise") rather than by quoting raw spec fields.',
50
52
  inputSchema,
51
53
  annotations: {
52
54
  readOnlyHint: true,
53
55
  openWorldHint: true,
54
56
  },
55
- }, this.handler);
57
+ }, (input, extra) => this.wrappedHandler(input, extra));
56
58
  }
57
59
  }
@@ -1,9 +1,14 @@
1
1
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { McpLogger } from '../../utils/logger.js';
2
3
  import z from 'zod';
3
- import { TextContentResponse, Tool } from '../../types.js';
4
+ import { McpToolResponse } from '../../types.js';
5
+ import { Tool } from '../../Tool.js';
4
6
  declare const inputSchemaZodObject: z.ZodObject<{
5
7
  absoluteCurrentWorkingDirectory: z.ZodString;
8
+ account: z.ZodOptional<z.ZodString>;
6
9
  docsSearchQuery: z.ZodString;
10
+ docsSearchLimit: z.ZodDefault<z.ZodNumber>;
11
+ docsSearchVersion: z.ZodDefault<z.ZodString>;
7
12
  }, z.z.core.$strip>;
8
13
  export interface DocsSearchResponse {
9
14
  results: {
@@ -12,12 +17,16 @@ export interface DocsSearchResponse {
12
17
  description: string;
13
18
  url: string;
14
19
  score: number;
20
+ version?: string;
15
21
  }[];
16
22
  }
17
23
  type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
18
24
  export declare class DocsSearchTool extends Tool<InputSchemaType> {
19
- constructor(mcpServer: McpServer);
20
- handler({ docsSearchQuery, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<TextContentResponse>;
25
+ constructor(mcpServer: McpServer, logger: McpLogger);
26
+ protected getTrackingMeta({ docsSearchQuery, }: InputSchemaType): {
27
+ [key: string]: string;
28
+ } | undefined;
29
+ handler({ docsSearchQuery, docsSearchLimit, docsSearchVersion, account, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<McpToolResponse>;
21
30
  register(): RegisteredTool;
22
31
  }
23
32
  export {};
@@ -1,16 +1,29 @@
1
1
  import { http } from '@hubspot/local-dev-lib/http';
2
2
  import z from 'zod';
3
- import { Tool } from '../../types.js';
3
+ import { Tool } from '../../Tool.js';
4
4
  import { formatTextContents } from '../../utils/content.js';
5
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
6
- import { absoluteCurrentWorkingDirectory, docsSearchQuery, } from './constants.js';
5
+ import { absoluteCurrentWorkingDirectory, account, docsSearchQuery, } from './constants.js';
7
6
  import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
8
- import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
9
7
  import { setupHubSpotConfig } from '../../utils/config.js';
8
+ import { resolveAccountId } from './resolveAccount.js';
10
9
  import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
10
+ const docsSearchLimit = z
11
+ .number()
12
+ .int()
13
+ .min(1)
14
+ .max(20)
15
+ .default(5)
16
+ .describe('Maximum number of results to return.');
17
+ const docsSearchVersion = z
18
+ .string()
19
+ .default('latest')
20
+ .describe('API documentation version to search. Defaults to "latest" for current docs, which is almost always what you want. Only override when the user explicitly asks about a specific or legacy version, using a date-based version like "2026-03" or "legacy". Versionless docs such as guides and CMS pages are always included regardless of this value.');
11
21
  const inputSchema = {
12
22
  absoluteCurrentWorkingDirectory,
23
+ account,
13
24
  docsSearchQuery,
25
+ docsSearchLimit,
26
+ docsSearchVersion,
14
27
  };
15
28
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
16
29
  const inputSchemaZodObject = z.object({
@@ -18,35 +31,55 @@ const inputSchemaZodObject = z.object({
18
31
  });
19
32
  const toolName = 'search-docs';
20
33
  export class DocsSearchTool extends Tool {
21
- constructor(mcpServer) {
22
- super(mcpServer);
34
+ constructor(mcpServer, logger) {
35
+ super(mcpServer, logger, toolName);
23
36
  }
24
- async handler({ docsSearchQuery, absoluteCurrentWorkingDirectory, }) {
37
+ getTrackingMeta({ docsSearchQuery, }) {
38
+ return { mode: docsSearchQuery };
39
+ }
40
+ async handler({ docsSearchQuery, docsSearchLimit, docsSearchVersion, account, absoluteCurrentWorkingDirectory, }) {
25
41
  setupHubSpotConfig(absoluteCurrentWorkingDirectory);
26
- await trackToolUsage(toolName, { mode: docsSearchQuery });
27
- const accountId = getConfigDefaultAccountIfExists()?.accountId;
28
- if (!accountId) {
29
- 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>\``;
30
- return formatTextContents(authErrorMessage);
31
- }
32
42
  try {
43
+ const resolved = await resolveAccountId(this.mcpServer, this.logger, {
44
+ toolName,
45
+ account,
46
+ });
47
+ if ('response' in resolved) {
48
+ return resolved.response;
49
+ }
50
+ const { accountId } = resolved;
33
51
  const response = await http.post(accountId, {
34
52
  url: 'dev/docs/llms/v1/docs-search',
35
53
  data: {
36
54
  query: docsSearchQuery,
55
+ version: docsSearchVersion,
37
56
  },
38
57
  });
39
58
  const results = response.data.results;
40
59
  if (!results || results.length === 0) {
41
60
  return formatTextContents('No documentation found for your query.');
42
61
  }
43
- const formattedResults = results
62
+ // The docs-search API returns duplicate URLs; dedupe to avoid wasting the result limit on repeats
63
+ const seen = new Set();
64
+ const dedupedResults = results.filter(result => {
65
+ if (seen.has(result.url)) {
66
+ return false;
67
+ }
68
+ seen.add(result.url);
69
+ return true;
70
+ });
71
+ const limitedResults = dedupedResults.slice(0, docsSearchLimit);
72
+ const formattedResults = limitedResults
44
73
  .map(result => `**${result.title}**\n${result.description}\nURL: ${result.url}\nScore: ${result.score}\n\n${result.content}\n---\n`)
45
74
  .join('\n');
46
- const successMessage = `Found ${results.length} documentation results:\n\n${formattedResults}`;
75
+ const successMessage = `Found ${dedupedResults.length} results, showing top ${limitedResults.length}:\n\n${formattedResults}`;
47
76
  return formatTextContents(successMessage);
48
77
  }
49
78
  catch (error) {
79
+ this.logger.debug(toolName, {
80
+ message: 'Handler caught error',
81
+ error: error instanceof Error ? error.message : String(error),
82
+ });
50
83
  if (isHubSpotHttpError(error)) {
51
84
  // Handle different status codes
52
85
  return formatTextContents(error.toString());
@@ -58,12 +91,12 @@ export class DocsSearchTool extends Tool {
58
91
  register() {
59
92
  return this.mcpServer.registerTool(toolName, {
60
93
  title: 'Search HubSpot Developer Documentation',
61
- description: 'Use this first whenever you need details about HubSpot APIs, SDKs, integrations, or developer platform features. This searches the official HubSpot Developer Documentation and returns the most relevant pages, each with a URL for use in `fetch-doc`. Always follow this with a fetch to get the full, authoritative content before making plans or writing answers.',
94
+ description: 'Use this first for any HubSpot developer question, including whether an API or feature is available on a subscription tier or plan (for example "is the content audit API available on Content Hub Professional"). The doc you fetch next states the required product and tier; report it in plain terms (for example "requires Content Hub Enterprise") rather than quoting raw spec fields. This searches the official HubSpot Developer Documentation and returns the most relevant pages, each with a URL for use in `fetch-doc`. Always follow this with a fetch to get the full, authoritative content before making plans or writing answers.',
62
95
  inputSchema,
63
96
  annotations: {
64
97
  readOnlyHint: true,
65
98
  openWorldHint: true,
66
99
  },
67
- }, this.handler);
100
+ }, (input, extra) => this.wrappedHandler(input, extra));
68
101
  }
69
102
  }
@@ -0,0 +1,15 @@
1
+ import { McpToolResponse } from '../../types.js';
2
+ import { Tool } from '../../Tool.js';
3
+ import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
4
+ import { McpLogger } from '../../utils/logger.js';
5
+ import { z } from 'zod';
6
+ declare const inputSchemaZodObject: z.ZodObject<{
7
+ absoluteDirectory: z.ZodString;
8
+ }, z.core.$strip>;
9
+ export type FindProjectsInputSchema = z.infer<typeof inputSchemaZodObject>;
10
+ export declare class FindProjectsTool extends Tool<FindProjectsInputSchema> {
11
+ constructor(mcpServer: McpServer, logger: McpLogger);
12
+ handler({ absoluteDirectory, }: FindProjectsInputSchema): Promise<McpToolResponse>;
13
+ register(): RegisteredTool;
14
+ }
15
+ export {};
@@ -0,0 +1,72 @@
1
+ import { Tool } from '../../Tool.js';
2
+ import { z } from 'zod';
3
+ import { formatTextContents } from '../../utils/content.js';
4
+ import { walk } from '@hubspot/local-dev-lib/fs';
5
+ import path from 'path';
6
+ import { PROJECT_CONFIG_FILE } from '../../../lib/constants.js';
7
+ import { elicitSelection } from '../../utils/elicitSelection.js';
8
+ const TOOL_NAME = 'find-projects';
9
+ const IGNORE_DIRS = ['node_modules', '.git', '.vite'];
10
+ const inputSchema = {
11
+ absoluteDirectory: z
12
+ .string()
13
+ .describe('The absolute path to the directory to search for HubSpot projects in.'),
14
+ };
15
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
16
+ const inputSchemaZodObject = z.object({ ...inputSchema });
17
+ export class FindProjectsTool extends Tool {
18
+ constructor(mcpServer, logger) {
19
+ super(mcpServer, logger, TOOL_NAME);
20
+ }
21
+ async handler({ absoluteDirectory, }) {
22
+ try {
23
+ const allFiles = await walk(absoluteDirectory, IGNORE_DIRS);
24
+ const projectFiles = allFiles.filter(file => path.basename(file) === PROJECT_CONFIG_FILE);
25
+ if (projectFiles.length === 0) {
26
+ return formatTextContents(`No ${PROJECT_CONFIG_FILE} files found under ${absoluteDirectory}.`);
27
+ }
28
+ const projectDirs = projectFiles.map(file => path.dirname(file));
29
+ if (projectDirs.length > 1) {
30
+ const selected = await elicitSelection(this.mcpServer, this.logger, {
31
+ message: 'Select the HubSpot project to use.',
32
+ title: 'HubSpot project',
33
+ options: projectDirs.map(dir => ({ value: dir, label: dir })),
34
+ });
35
+ if (selected) {
36
+ return formatTextContents(`Selected project: ${selected}`);
37
+ }
38
+ return formatTextContents(`Several projects are available. Ask the user which to use, then call ${TOOL_NAME} again with absoluteDirectory narrowed to one of: ${projectDirs.join(', ')}.`);
39
+ }
40
+ const output = [
41
+ `Found ${projectFiles.length} project(s):`,
42
+ '',
43
+ ...projectDirs.map(dir => ` ${dir}`),
44
+ ].join('\n');
45
+ return formatTextContents(output);
46
+ }
47
+ catch (error) {
48
+ this.logger.debug(TOOL_NAME, {
49
+ message: 'Handler caught error',
50
+ error: error instanceof Error ? error.message : String(error),
51
+ });
52
+ const cause = error instanceof Error ? error.cause : undefined;
53
+ const causeMessage = cause instanceof Error ? `: ${cause.message}` : '';
54
+ const errorMessage = error instanceof Error
55
+ ? error.message || `FileSystemError${causeMessage}`
56
+ : String(error);
57
+ return formatTextContents(`Error searching for projects: ${errorMessage}`);
58
+ }
59
+ }
60
+ register() {
61
+ return this.mcpServer.registerTool(TOOL_NAME, {
62
+ title: 'Find HubSpot Projects',
63
+ description: 'Use this tool to locate HubSpot projects. Traverses child directories of the given directory to find hsproject.json files, returning the paths of all discovered HubSpot projects.',
64
+ inputSchema,
65
+ annotations: {
66
+ readOnlyHint: true,
67
+ openWorldHint: false,
68
+ idempotentHint: true,
69
+ },
70
+ }, (input, extra) => this.wrappedHandler(input, extra));
71
+ }
72
+ }
@@ -1,16 +1,20 @@
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;
6
- appId: z.ZodString;
8
+ absoluteProjectPath: z.ZodOptional<z.ZodString>;
9
+ account: z.ZodOptional<z.ZodString>;
10
+ appId: z.ZodOptional<z.ZodString>;
7
11
  startDate: z.ZodOptional<z.ZodString>;
8
12
  endDate: z.ZodOptional<z.ZodString>;
9
13
  }, z.core.$strip>;
10
14
  export type GetApiUsagePatternsByAppIdInputSchema = z.infer<typeof inputSchemaZodObject>;
11
15
  export declare class GetApiUsagePatternsByAppIdTool extends Tool<GetApiUsagePatternsByAppIdInputSchema> {
12
- constructor(mcpServer: McpServer);
13
- handler({ appId, startDate, endDate, absoluteCurrentWorkingDirectory, }: GetApiUsagePatternsByAppIdInputSchema): Promise<TextContentResponse>;
16
+ constructor(mcpServer: McpServer, logger: McpLogger);
17
+ handler({ appId, startDate, endDate, account, absoluteCurrentWorkingDirectory, absoluteProjectPath, }: GetApiUsagePatternsByAppIdInputSchema): Promise<McpToolResponse>;
14
18
  register(): RegisteredTool;
15
19
  }
16
20
  export {};
@@ -1,18 +1,22 @@
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 { http } from '@hubspot/local-dev-lib/http';
5
4
  import { formatTextContents } from '../../utils/content.js';
6
5
  import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
7
- import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
8
- import { absoluteCurrentWorkingDirectory } from './constants.js';
6
+ import { absoluteCurrentWorkingDirectory, absoluteProjectPath, account, } from './constants.js';
9
7
  import { setupHubSpotConfig } from '../../utils/config.js';
8
+ import { resolveAccountId } from './resolveAccount.js';
10
9
  import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
10
+ import { elicitSelection } from '../../utils/elicitSelection.js';
11
+ import { getApps } from './apps.js';
11
12
  const inputSchema = {
12
13
  absoluteCurrentWorkingDirectory,
14
+ absoluteProjectPath: absoluteProjectPath.optional(),
15
+ account,
13
16
  appId: z
14
17
  .string()
15
- .describe('The numeric app ID as a string (e.g., "3003909"). Must contain only digits. Use get-apps-info to find available app IDs.'),
18
+ .describe('The numeric app ID as a string (e.g., "3003909"). Must contain only digits. If omitted and the account has several apps, you will be asked to choose one.')
19
+ .optional(),
16
20
  startDate: z
17
21
  .string()
18
22
  .describe('Start date for the usage patterns query in YYYY-MM-DD format (e.g., 2025-01-01).')
@@ -26,21 +30,44 @@ const inputSchema = {
26
30
  const inputSchemaZodObject = z.object({ ...inputSchema });
27
31
  const toolName = 'get-api-usage-patterns-by-app-id';
28
32
  export class GetApiUsagePatternsByAppIdTool extends Tool {
29
- constructor(mcpServer) {
30
- super(mcpServer);
33
+ constructor(mcpServer, logger) {
34
+ super(mcpServer, logger, toolName);
31
35
  }
32
- async handler({ appId, startDate, endDate, absoluteCurrentWorkingDirectory, }) {
33
- setupHubSpotConfig(absoluteCurrentWorkingDirectory);
34
- await trackToolUsage(toolName);
36
+ async handler({ appId, startDate, endDate, account, absoluteCurrentWorkingDirectory, absoluteProjectPath, }) {
37
+ setupHubSpotConfig(absoluteProjectPath ?? absoluteCurrentWorkingDirectory);
35
38
  try {
36
- // Get account ID from CLI config
37
- const accountId = getConfigDefaultAccountIfExists()?.accountId;
38
- if (!accountId) {
39
- 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>\``;
40
- return formatTextContents(authErrorMessage);
39
+ const resolved = await resolveAccountId(this.mcpServer, this.logger, {
40
+ toolName,
41
+ account,
42
+ });
43
+ if ('response' in resolved) {
44
+ return resolved.response;
45
+ }
46
+ const { accountId } = resolved;
47
+ let resolvedAppId = appId;
48
+ if (!resolvedAppId) {
49
+ const { applications } = await getApps(accountId);
50
+ const apps = applications ?? [];
51
+ if (apps.length === 0) {
52
+ return formatTextContents('No apps found for this account. Nothing to inspect.');
53
+ }
54
+ const selected = await elicitSelection(this.mcpServer, this.logger, {
55
+ message: 'Select the app to inspect usage patterns for.',
56
+ title: 'HubSpot app',
57
+ options: apps.map(app => ({
58
+ value: String(app.appId),
59
+ label: `${app.appName} (${app.appId})`,
60
+ })),
61
+ });
62
+ if (!selected) {
63
+ return formatTextContents(`Several apps are available. Ask the user which to use, then call ${toolName} again with the appId argument set to one of: ${apps
64
+ .map(app => `${app.appName} (appId ${app.appId})`)
65
+ .join(', ')}.`);
66
+ }
67
+ resolvedAppId = selected;
41
68
  }
42
69
  const response = await http.get(accountId, {
43
- url: `app/feature/utilization/public/v3/insights/app/${appId}/usage-patterns`,
70
+ url: `app/feature/utilization/public/v3/insights/app/${resolvedAppId}/usage-patterns`,
44
71
  params: {
45
72
  ...(startDate && { startDate }),
46
73
  ...(endDate && { endDate }),
@@ -52,6 +79,10 @@ export class GetApiUsagePatternsByAppIdTool extends Tool {
52
79
  return formatTextContents(formattedResult);
53
80
  }
54
81
  catch (error) {
82
+ this.logger.debug(toolName, {
83
+ message: 'Handler caught error',
84
+ error: error instanceof Error ? error.message : String(error),
85
+ });
55
86
  if (isHubSpotHttpError(error)) {
56
87
  // Handle HubSpot-specific HTTP errors
57
88
  return formatTextContents(error.toString());
@@ -68,6 +99,6 @@ export class GetApiUsagePatternsByAppIdTool extends Tool {
68
99
  readOnlyHint: true,
69
100
  openWorldHint: true,
70
101
  },
71
- }, this.handler);
102
+ }, (input, extra) => this.wrappedHandler(input, extra));
72
103
  }
73
104
  }
@@ -1,13 +1,17 @@
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>;
9
+ account: z.ZodOptional<z.ZodString>;
6
10
  }, z.core.$strip>;
7
11
  export type GetApplicationInfoInputSchema = z.infer<typeof inputSchemaZodObject>;
8
12
  export declare class GetApplicationInfoTool extends Tool<GetApplicationInfoInputSchema> {
9
- constructor(mcpServer: McpServer);
10
- handler({ absoluteCurrentWorkingDirectory, }: GetApplicationInfoInputSchema): Promise<TextContentResponse>;
13
+ constructor(mcpServer: McpServer, logger: McpLogger);
14
+ handler({ account, absoluteCurrentWorkingDirectory, absoluteProjectPath, }: GetApplicationInfoInputSchema): Promise<McpToolResponse>;
11
15
  register(): RegisteredTool;
12
16
  }
13
17
  export {};
@@ -1,40 +1,44 @@
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
- import { http } from '@hubspot/local-dev-lib/http';
5
3
  import { formatTextContents } from '../../utils/content.js';
6
4
  import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
7
- import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
8
- import { absoluteCurrentWorkingDirectory } from './constants.js';
5
+ import { absoluteCurrentWorkingDirectory, absoluteProjectPath, account, } from './constants.js';
9
6
  import { setupHubSpotConfig } from '../../utils/config.js';
7
+ import { resolveAccountId } from './resolveAccount.js';
10
8
  import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
11
- const inputSchema = { absoluteCurrentWorkingDirectory };
9
+ import { getApps } from './apps.js';
10
+ const inputSchema = {
11
+ absoluteCurrentWorkingDirectory,
12
+ absoluteProjectPath: absoluteProjectPath.optional(),
13
+ account,
14
+ };
12
15
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
13
16
  const inputSchemaZodObject = z.object({ ...inputSchema });
14
17
  const toolName = 'get-apps-info';
15
18
  export class GetApplicationInfoTool extends Tool {
16
- constructor(mcpServer) {
17
- super(mcpServer);
19
+ constructor(mcpServer, logger) {
20
+ super(mcpServer, logger, toolName);
18
21
  }
19
- async handler({ absoluteCurrentWorkingDirectory, }) {
20
- setupHubSpotConfig(absoluteCurrentWorkingDirectory);
21
- await trackToolUsage(toolName);
22
+ async handler({ account, absoluteCurrentWorkingDirectory, absoluteProjectPath, }) {
23
+ setupHubSpotConfig(absoluteProjectPath ?? absoluteCurrentWorkingDirectory);
22
24
  try {
23
- // Get account ID from CLI config
24
- const accountId = getConfigDefaultAccountIfExists()?.accountId;
25
- if (!accountId) {
26
- 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>\``;
27
- return formatTextContents(authErrorMessage);
28
- }
29
- const response = await http.get(accountId, {
30
- url: `app/feature/utilization/public/v3/insights/apps`,
25
+ const resolved = await resolveAccountId(this.mcpServer, this.logger, {
26
+ toolName,
27
+ account,
31
28
  });
32
- // Format the response for display
33
- const { data } = response;
29
+ if ('response' in resolved) {
30
+ return resolved.response;
31
+ }
32
+ const { accountId } = resolved;
33
+ const data = await getApps(accountId);
34
34
  const formattedResult = JSON.stringify(data, null, 2);
35
35
  return formatTextContents(formattedResult);
36
36
  }
37
37
  catch (error) {
38
+ this.logger.debug(toolName, {
39
+ message: 'Handler caught error',
40
+ error: error instanceof Error ? error.message : String(error),
41
+ });
38
42
  if (isHubSpotHttpError(error)) {
39
43
  // Handle HubSpot-specific HTTP errors
40
44
  return formatTextContents(error.toString());
@@ -51,6 +55,6 @@ export class GetApplicationInfoTool extends Tool {
51
55
  readOnlyHint: true,
52
56
  openWorldHint: true,
53
57
  },
54
- }, this.handler);
58
+ }, (input, extra) => this.wrappedHandler(input, extra));
55
59
  }
56
60
  }