@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
@@ -2,22 +2,26 @@ 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';
7
- import { absoluteCurrentWorkingDirectory, absoluteProjectPath, } from './constants.js';
8
- import { formatTextContent, formatTextContents } from '../../utils/content.js';
9
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
10
- import { addFlag } from '../../utils/command.js';
5
+ import { Tool } from '../../Tool.js';
6
+ import { absoluteProjectPath, confirmProductionAccount } from './constants.js';
7
+ import { formatErrorTextContents, formatTextContent, formatTextContents, } from '../../utils/content.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
+ import { discoverAccountTargets } from '../../../lib/accountTargetDiscovery.js';
13
+ import { generateProfilePromptOption } from '../../../lib/prompts/projectProfilePrompt.js';
14
+ import { elicitSelection } from '../../utils/elicitSelection.js';
15
+ import { confirmProductionTargets, setTargetAccount, } from './productionConfirmation.js';
12
16
  const inputSchema = {
13
17
  absoluteProjectPath,
14
- absoluteCurrentWorkingDirectory,
15
18
  uploadMessage: z
16
19
  .string()
17
20
  .describe('A 1 sentence message that concisely describes the changes that are being uploaded.'),
18
21
  profile: z
19
22
  .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".'),
23
+ .describe('The profile to use for the upload. Only set this when the user names a profile. If it is omitted and the project uses profiles, the tool asks the user to choose one. NEVER automatically choose a profile based on files you see. Profile files have the format: "hsprofile.<profile>.json".'),
24
+ confirmProductionAccount,
21
25
  };
22
26
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
23
27
  const inputSchemaZodObject = z.object({
@@ -25,59 +29,76 @@ const inputSchemaZodObject = z.object({
25
29
  });
26
30
  const toolName = 'upload-project';
27
31
  export class UploadProjectTools extends Tool {
28
- constructor(mcpServer) {
29
- super(mcpServer);
32
+ constructor(mcpServer, logger) {
33
+ super(mcpServer, logger, toolName);
30
34
  }
31
- async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, profile, uploadMessage, }) {
32
- setupHubSpotConfig(absoluteCurrentWorkingDirectory);
33
- await trackToolUsage(toolName);
34
- let command = addFlag('hs project upload', 'force-create', true);
35
- const content = [];
36
- if (uploadMessage) {
37
- command = addFlag(command, 'message', uploadMessage);
38
- }
39
- if (profile) {
40
- command = addFlag(command, 'profile', profile);
41
- }
42
- else {
43
- let hasProfiles = false;
44
- 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;
35
+ async handler({ absoluteProjectPath, profile, uploadMessage, confirmProductionAccount, }, extra) {
36
+ setupHubSpotConfig(absoluteProjectPath);
37
+ const { projectDir, projectConfig } = getProjectConfig(absoluteProjectPath);
38
+ let selectedProfile = profile;
39
+ if (!selectedProfile) {
40
+ const profiles = await getAllHsProfiles(path.join(projectDir, projectConfig.srcDir));
41
+ if (profiles.length > 0) {
42
+ const options = profiles.map(profileName => ({
43
+ value: profileName,
44
+ label: generateProfilePromptOption(projectDir, projectConfig, profileName).name,
45
+ }));
46
+ selectedProfile = await elicitSelection(this.mcpServer, this.logger, {
47
+ message: 'Select the profile to use for the upload.',
48
+ title: 'Project profile',
49
+ options,
50
+ });
51
+ if (!selectedProfile) {
52
+ return formatErrorTextContents(`Several profiles are available. Ask the user which to use, then call ${toolName} again with the profile argument set to one of these profile names: ${options
53
+ .map(option => option.value)
54
+ .join(', ')}. The profiles target these accounts: ${options
55
+ .map(option => option.label)
56
+ .join(', ')}.`);
49
57
  }
50
58
  }
51
- catch (e) {
52
- // If any of these checks fail, the safest thing to do is to assume there are no profiles.
53
- hasProfiles = false;
54
- }
55
- if (hasProfiles) {
56
- content.push(formatTextContent(`Ask the user which profile they would like to use for the upload.`));
57
- }
58
59
  }
59
- if (content.length > 0) {
60
- return {
61
- content,
62
- };
60
+ const targets = await discoverAccountTargets({
61
+ projectDir,
62
+ projectConfig,
63
+ profileName: selectedProfile,
64
+ });
65
+ const blockedResponse = await confirmProductionTargets(this.mcpServer, this.logger, {
66
+ targets,
67
+ action: `Upload ${projectConfig.name}`,
68
+ toolName,
69
+ confirmedInConversation: confirmProductionAccount,
70
+ });
71
+ if (blockedResponse) {
72
+ return blockedResponse;
73
+ }
74
+ const command = new HubSpotCommand('project upload', [
75
+ { name: 'force', value: true },
76
+ { name: 'json', value: true },
77
+ ]);
78
+ if (uploadMessage) {
79
+ command.addFlag('message', uploadMessage);
63
80
  }
64
- const { stdout, stderr } = await runCommandInDir(absoluteProjectPath, command);
81
+ setTargetAccount(command, targets, selectedProfile);
82
+ const { stdout, stderr } = await this.runCommand(absoluteProjectPath, command, extra);
65
83
  const response = await formatTextContents(stdout, stderr);
66
84
  // Add reminder about cards needing to be added to views
67
85
  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.'));
86
+ response.structuredContent =
87
+ parseCommandJsonOutput(stdout, ProjectUploadSchema, this.logger, toolName) ?? {};
68
88
  return response;
69
89
  }
70
90
  register() {
71
91
  return this.mcpServer.registerTool(toolName, {
72
92
  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.',
93
+ 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. Uploads 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.',
74
94
  inputSchema,
95
+ outputSchema: ProjectUploadSchema.shape,
75
96
  annotations: {
76
97
  readOnlyHint: false,
77
98
  destructiveHint: true,
78
99
  idempotentHint: true,
79
100
  openWorldHint: true,
80
101
  },
81
- }, this.handler);
102
+ }, (input, extra) => this.wrappedHandler(input, extra));
82
103
  }
83
104
  }
@@ -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
  }
@@ -0,0 +1,8 @@
1
+ export interface AppInfo {
2
+ appId: number;
3
+ appName: string;
4
+ }
5
+ export interface GetAppsResponse {
6
+ applications: AppInfo[];
7
+ }
8
+ export declare function getApps(accountId: number): Promise<GetAppsResponse>;
@@ -0,0 +1,7 @@
1
+ import { http } from '@hubspot/local-dev-lib/http';
2
+ export async function getApps(accountId) {
3
+ const response = await http.get(accountId, {
4
+ url: 'app/feature/utilization/public/v3/insights/apps',
5
+ });
6
+ return response.data;
7
+ }
@@ -1,18 +1,22 @@
1
1
  import z from 'zod';
2
2
  export declare const absoluteProjectPath: z.ZodString;
3
3
  export declare const absoluteCurrentWorkingDirectory: z.ZodString;
4
+ export declare const account: z.ZodOptional<z.ZodString>;
5
+ export declare const confirmProductionAccount: z.ZodOptional<z.ZodBoolean>;
4
6
  export declare const features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
5
7
  card: "card";
6
8
  settings: "settings";
9
+ "crm-bulk-action": "crm-bulk-action";
7
10
  "app-event": "app-event";
8
11
  "workflow-action-tool": "workflow-action-tool";
9
12
  page: "page";
10
13
  webhooks: "webhooks";
11
- "workflow-action": "workflow-action";
12
14
  "app-function": "app-function";
13
- "app-function-endpoint": "app-function-endpoint";
14
15
  "app-object": "app-object";
15
16
  scim: "scim";
17
+ "workflow-action": "workflow-action";
18
+ "app-function-endpoint": "app-function-endpoint";
16
19
  }>>>;
17
20
  export declare const docsSearchQuery: z.ZodString;
18
21
  export declare const docUrl: z.ZodString;
22
+ export declare const knowledgeSearchQuery: z.ZodString;
@@ -5,6 +5,13 @@ export const absoluteProjectPath = z
5
5
  export const absoluteCurrentWorkingDirectory = z
6
6
  .string()
7
7
  .describe('The absolute path to the current working directory.');
8
+ export const account = z
9
+ .string()
10
+ .optional()
11
+ .describe('Optional: the HubSpot account ID or name to use. If omitted and several accounts are available, you will be asked to choose.');
12
+ export const confirmProductionAccount = z
13
+ .optional(z.boolean())
14
+ .describe('Set to true only after this tool names a production account and the user then explicitly confirms that account in the conversation. NEVER set this on your own. The tool ignores this value when the client can show a confirmation form.');
8
15
  export const features = z
9
16
  .array(z.enum([
10
17
  'card',
@@ -18,8 +25,9 @@ export const features = z
18
25
  'app-event',
19
26
  'scim',
20
27
  'page',
28
+ 'crm-bulk-action',
21
29
  ]))
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.')
30
+ .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
31
  .optional();
24
32
  export const docsSearchQuery = z
25
33
  .string()
@@ -27,3 +35,6 @@ export const docsSearchQuery = z
27
35
  export const docUrl = z
28
36
  .string()
29
37
  .describe('The URL of the HubSpot Developer Documentation to fetch.');
38
+ export const knowledgeSearchQuery = z
39
+ .string()
40
+ .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".');
@@ -0,0 +1,12 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { DiscoverAccountTargetsResult } from '../../../types/AccountTargets.js';
3
+ import { McpToolResponse } from '../../types.js';
4
+ import { HubSpotCommand } from '../../utils/command.js';
5
+ import { McpLogger } from '../../utils/logger.js';
6
+ export declare function setTargetAccount(command: HubSpotCommand, { recommended }: DiscoverAccountTargetsResult, profileName?: string): void;
7
+ export declare function confirmProductionTargets(mcpServer: McpServer, logger: McpLogger, { targets, action, toolName, confirmedInConversation, }: {
8
+ targets: DiscoverAccountTargetsResult;
9
+ action: string;
10
+ toolName: string;
11
+ confirmedInConversation?: boolean;
12
+ }): Promise<McpToolResponse | undefined>;
@@ -0,0 +1,45 @@
1
+ import { ACCOUNT_TARGET_CATEGORIES, } from '../../../types/AccountTargets.js';
2
+ import { uiAccountDescription } from '../../../lib/ui/index.js';
3
+ import { formatErrorTextContents } from '../../utils/content.js';
4
+ import { canElicit, requestElicitation } from '../../utils/elicitation.js';
5
+ // Sets the command to run against the account that was checked. hs rejects
6
+ // --profile with --account, and a profile already sets the account, so a
7
+ // profile wins.
8
+ export function setTargetAccount(command, { recommended }, profileName) {
9
+ if (profileName) {
10
+ command.addFlag('profile', profileName);
11
+ return;
12
+ }
13
+ if (recommended) {
14
+ command.addFlag('account', recommended.accountId);
15
+ }
16
+ }
17
+ // Without a recommended account the command can act on any candidate, so every
18
+ // production candidate is a possible target.
19
+ function getProductionTargets({ candidates, recommended, }) {
20
+ return (recommended ? [recommended] : candidates).filter(candidate => candidate.category === ACCOUNT_TARGET_CATEGORIES.PRODUCTION_WITH_CARE);
21
+ }
22
+ // Returns an error response when the action must not run, or `undefined` when
23
+ // it can run. `confirmedInConversation` only counts when the client cannot show
24
+ // a confirmation form.
25
+ export async function confirmProductionTargets(mcpServer, logger, { targets, action, toolName, confirmedInConversation, }) {
26
+ const productionTargets = getProductionTargets(targets);
27
+ if (productionTargets.length === 0) {
28
+ return undefined;
29
+ }
30
+ const accounts = productionTargets
31
+ .map(({ accountId }) => uiAccountDescription(accountId, false))
32
+ .join(' or ');
33
+ if (!canElicit(mcpServer)) {
34
+ return confirmedInConversation
35
+ ? undefined
36
+ : formatErrorTextContents(`${action} targets production account ${accounts}, which is not a test account or sandbox. Ask the user to confirm this account. If the user confirms, call ${toolName} again with confirmProductionAccount set to true.`);
37
+ }
38
+ // A failed or timed-out request counts as a decline, so the flag cannot skip
39
+ // the form.
40
+ const elicitation = await requestElicitation(mcpServer, { message: `${action} to production account ${accounts}?`, fields: {} }, logger);
41
+ if (elicitation?.action === 'accept') {
42
+ return undefined;
43
+ }
44
+ return formatErrorTextContents(`The user did not confirm production account ${accounts}, so ${toolName} did not run. Tell the user that the action was canceled. Do not ask the user to confirm again, and do not call ${toolName} again unless the user asks.`);
45
+ }
@@ -0,0 +1,15 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { McpToolResponse } from '../../types.js';
3
+ import { McpLogger } from '../../utils/logger.js';
4
+ import { DiscoverAccountTargetsOptions } from '../../../types/AccountTargets.js';
5
+ export type ResolveAccountResult = {
6
+ accountId: number;
7
+ } | {
8
+ response: McpToolResponse;
9
+ };
10
+ export declare function resolveAccountId(mcpServer: McpServer, logger: McpLogger, params: {
11
+ toolName: string;
12
+ absoluteCurrentWorkingDirectory?: string;
13
+ account?: string;
14
+ discoverOptions?: DiscoverAccountTargetsOptions;
15
+ }): Promise<ResolveAccountResult>;
@@ -0,0 +1,60 @@
1
+ import { formatTextContents } from '../../utils/content.js';
2
+ import { enumField, requestElicitation } from '../../utils/elicitation.js';
3
+ import { discoverAccountTargets } from '../../../lib/accountTargetDiscovery.js';
4
+ function formatAccountChoice(candidate) {
5
+ const name = candidate.accountName || String(candidate.accountId);
6
+ const parts = [`${name} (${candidate.category})`];
7
+ if (candidate.profileName) {
8
+ parts.push(`[profile: ${candidate.profileName}]`);
9
+ }
10
+ return parts.join(' ');
11
+ }
12
+ function fallbackResponse(message, absoluteCurrentWorkingDirectory) {
13
+ return absoluteCurrentWorkingDirectory
14
+ ? formatTextContents(absoluteCurrentWorkingDirectory, message)
15
+ : formatTextContents(message);
16
+ }
17
+ // Resolves the HubSpot account a tool should act on. Returns a numeric
18
+ // accountId when one is the obvious choice or the caller supplied a matching
19
+ // `account`. When several accounts are available and none is recommended, it
20
+ // asks the client to pick via elicitation. When the client cannot elicit (or
21
+ // declines), it returns a text response listing the candidates so the caller
22
+ // can return it directly. `toolName` names the tool in that fallback text.
23
+ export async function resolveAccountId(mcpServer, logger, params) {
24
+ const { candidates, recommended } = await discoverAccountTargets({
25
+ ...params.discoverOptions,
26
+ explicitAccount: params.account,
27
+ });
28
+ const available = candidates ?? [];
29
+ let accountId = recommended?.accountId;
30
+ if (!accountId && params.account) {
31
+ const match = available.find(candidate => String(candidate.accountId) === params.account ||
32
+ candidate.accountName === params.account);
33
+ accountId = match?.accountId;
34
+ }
35
+ if (!accountId && available.length > 0) {
36
+ const elicitation = await requestElicitation(mcpServer, {
37
+ message: 'Select the HubSpot account to use.',
38
+ fields: {
39
+ account: enumField('HubSpot account', 'The account to use for this request.', available.map(candidate => String(candidate.accountId)), available.map(formatAccountChoice)),
40
+ },
41
+ required: ['account'],
42
+ }, logger);
43
+ if (elicitation?.action === 'accept' && elicitation.content) {
44
+ accountId = Number(elicitation.content.account);
45
+ }
46
+ }
47
+ if (!accountId) {
48
+ if (available.length > 0) {
49
+ return {
50
+ response: await fallbackResponse(`Several HubSpot accounts are available. Ask the user which to use, then call ${params.toolName} again with the account argument set to one of: ${available
51
+ .map(candidate => `${formatAccountChoice(candidate)} (id ${candidate.accountId})`)
52
+ .join(', ')}.`, params.absoluteCurrentWorkingDirectory),
53
+ };
54
+ }
55
+ return {
56
+ response: await fallbackResponse('No account ID found. Call the auth-account tool to authenticate a HubSpot account.', params.absoluteCurrentWorkingDirectory),
57
+ };
58
+ }
59
+ return { accountId };
60
+ }
@@ -1,14 +1,9 @@
1
- import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
2
- export declare class Tool<InputSchema, ResponseType = TextContentResponse> {
3
- protected mcpServer: McpServer;
4
- constructor(mcpServer: McpServer);
5
- register(): RegisteredTool;
6
- handler(input: InputSchema): ResponseType | Promise<ResponseType>;
7
- }
8
1
  export type TextContent = {
9
2
  type: 'text';
10
3
  text: string;
11
4
  };
12
- export type TextContentResponse = {
5
+ export type McpToolResponse = {
13
6
  content: TextContent[];
7
+ structuredContent?: Record<string, unknown>;
8
+ isError?: boolean;
14
9
  };
@@ -1,13 +1 @@
1
- export class Tool {
2
- mcpServer;
3
- constructor(mcpServer) {
4
- this.mcpServer = mcpServer;
5
- }
6
- register() {
7
- throw new Error('Must implement register');
8
- }
9
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
10
- handler(input) {
11
- throw new Error('Must implement handler');
12
- }
13
- }
1
+ export {};
@@ -1,8 +1,32 @@
1
1
  import { exec } from 'node:child_process';
2
+ export interface Command {
3
+ executable: string;
4
+ args: string[];
5
+ }
6
+ export type FlagValue = string | number | boolean | string[];
7
+ export interface Flag {
8
+ name: string;
9
+ value: FlagValue;
10
+ }
11
+ export declare class HubSpotCommand implements Command {
12
+ readonly executable = "hs";
13
+ private readonly subcommandArgs;
14
+ private readonly positionalArgs;
15
+ private readonly flags;
16
+ constructor(subcommand: string, flags?: Flag[]);
17
+ addArg(value: string): this;
18
+ addFlag(name: string, value: FlagValue): this;
19
+ get args(): string[];
20
+ }
21
+ export declare class NpxHubSpotCommand implements Command {
22
+ readonly executable = "npx";
23
+ readonly args: string[];
24
+ constructor(command: Command, cliPackage?: string);
25
+ }
2
26
  export declare const execAsync: typeof exec.__promisify__;
3
- export declare function addFlag(command: string, flagName: string, value: string | number | boolean | string[]): string;
4
27
  export interface CommandResults {
5
28
  stderr: string;
6
29
  stdout: string;
7
30
  }
8
- export declare function runCommandInDir(directory: string, command: string): Promise<CommandResults>;
31
+ export declare function getCommandResultsFromError(error: unknown): CommandResults;
32
+ export declare function runCommandInDir(directory: string, command: Command, onData?: (chunk: string, source: 'stdout' | 'stderr') => void): Promise<CommandResults>;
@@ -1,33 +1,93 @@
1
1
  import path from 'path';
2
2
  import fs from 'fs';
3
3
  import util from 'util';
4
- import { exec } from 'node:child_process';
4
+ import { exec, spawn } from 'node:child_process';
5
+ export class HubSpotCommand {
6
+ executable = 'hs';
7
+ subcommandArgs;
8
+ positionalArgs;
9
+ flags;
10
+ constructor(subcommand, flags = []) {
11
+ this.subcommandArgs = subcommand.trim().split(/\s+/);
12
+ this.positionalArgs = [];
13
+ this.flags = [...flags];
14
+ }
15
+ addArg(value) {
16
+ this.positionalArgs.push(value);
17
+ return this;
18
+ }
19
+ addFlag(name, value) {
20
+ this.flags.push({ name, value });
21
+ return this;
22
+ }
23
+ get args() {
24
+ return [
25
+ ...this.subcommandArgs,
26
+ ...this.positionalArgs,
27
+ ...this.flags.flatMap(({ name, value }) => Array.isArray(value)
28
+ ? [`--${name}`, ...value.map(String)]
29
+ : [`--${name}`, String(value)]),
30
+ ];
31
+ }
32
+ }
33
+ export class NpxHubSpotCommand {
34
+ executable = 'npx';
35
+ args;
36
+ constructor(command, cliPackage = '@hubspot/cli') {
37
+ this.args = ['-y', '-p', cliPackage, 'hs', ...command.args];
38
+ }
39
+ }
5
40
  export const execAsync = util.promisify(exec);
6
- export function addFlag(command, flagName, value) {
7
- if (Array.isArray(value)) {
8
- return `${command} --${flagName} ${value.map(item => `"${item}"`).join(' ')}`;
41
+ export function getCommandResultsFromError(error) {
42
+ if (typeof error !== 'object' || error === null) {
43
+ return { stdout: '', stderr: '' };
9
44
  }
10
- return `${command} --${flagName} "${value}"`;
45
+ const stdout = 'stdout' in error && typeof error.stdout === 'string' ? error.stdout : '';
46
+ const stderr = 'stderr' in error && typeof error.stderr === 'string' ? error.stderr : '';
47
+ return { stdout, stderr };
11
48
  }
12
- export async function runCommandInDir(directory, command) {
49
+ export async function runCommandInDir(directory, command, onData) {
13
50
  if (!fs.existsSync(directory)) {
14
51
  fs.mkdirSync(directory);
15
52
  }
16
53
  let finalCommand = command;
17
- if (command.startsWith('hs ')) {
18
- // Check if running in standalone mode
54
+ if (command instanceof HubSpotCommand) {
55
+ command.addFlag('disable-usage-tracking', 'true');
19
56
  if (process.env.HUBSPOT_MCP_STANDALONE === 'true') {
20
57
  const cliPackage = process.env.HUBSPOT_CLI_VERSION
21
58
  ? `@hubspot/cli@${process.env.HUBSPOT_CLI_VERSION}`
22
59
  : '@hubspot/cli';
23
- finalCommand = command.replace(/^hs /, `npx -y -p ${cliPackage} hs `);
60
+ finalCommand = new NpxHubSpotCommand(command, cliPackage);
24
61
  }
25
- finalCommand = addFlag(finalCommand, 'disable-usage-tracking', true);
26
62
  }
27
- return execAsync(finalCommand, {
28
- cwd: path.resolve(directory),
29
- env: {
30
- ...process.env,
31
- },
63
+ const resolvedDir = path.resolve(directory);
64
+ return new Promise((resolve, reject) => {
65
+ const stdoutChunks = [];
66
+ const stderrChunks = [];
67
+ const child = spawn(finalCommand.executable, finalCommand.args, {
68
+ cwd: resolvedDir,
69
+ env: { ...process.env, INIT_CWD: resolvedDir },
70
+ });
71
+ child.stdout.on('data', (chunk) => {
72
+ const text = chunk.toString();
73
+ stdoutChunks.push(text);
74
+ onData?.(text, 'stdout');
75
+ });
76
+ child.stderr.on('data', (chunk) => {
77
+ const text = chunk.toString();
78
+ stderrChunks.push(text);
79
+ onData?.(text, 'stderr');
80
+ });
81
+ child.on('error', reject);
82
+ child.on('close', code => {
83
+ const stdout = stdoutChunks.join('');
84
+ const stderr = stderrChunks.join('');
85
+ if (code !== 0) {
86
+ reject(Object.assign(new Error(`Command failed: ${finalCommand.executable} ${finalCommand.args.join(' ')}\n${stderr}`), { code, stdout, stderr }));
87
+ }
88
+ else {
89
+ resolve({ stdout, stderr });
90
+ }
91
+ });
32
92
  });
33
93
  }