@hubspot/cli 8.3.0-beta.1 → 8.3.0-experimental.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (813) hide show
  1. package/api/migrate.js +3 -3
  2. package/api/releases.d.ts +39 -0
  3. package/api/releases.js +41 -0
  4. package/bin/cli.js +18 -7
  5. package/bin/hs.js +1 -0
  6. package/bin/hscms.js +1 -0
  7. package/bin/setupColor.d.ts +2 -0
  8. package/bin/setupColor.js +10 -0
  9. package/commands/account/auth.d.ts +6 -3
  10. package/commands/account/auth.js +48 -29
  11. package/commands/account/clean.js +7 -6
  12. package/commands/account/createOverride.js +10 -7
  13. package/commands/account/info.js +36 -17
  14. package/commands/account/link.d.ts +4 -0
  15. package/commands/account/link.js +87 -0
  16. package/commands/account/list.js +32 -76
  17. package/commands/account/remove.js +4 -3
  18. package/commands/account/removeOverride.js +11 -10
  19. package/commands/account/rename.js +5 -6
  20. package/commands/account/unlink.d.ts +4 -0
  21. package/commands/account/unlink.js +68 -0
  22. package/commands/account/use.js +79 -20
  23. package/commands/account.js +4 -0
  24. package/commands/api.d.ts +13 -0
  25. package/commands/api.js +161 -0
  26. package/commands/app/logDetails.d.ts +9 -0
  27. package/commands/app/logDetails.js +86 -0
  28. package/commands/app/logs.d.ts +13 -0
  29. package/commands/app/logs.js +126 -0
  30. package/commands/app/migrate.js +12 -12
  31. package/commands/app/secret/add.js +6 -7
  32. package/commands/app/secret/delete.js +9 -10
  33. package/commands/app/secret/list.js +6 -7
  34. package/commands/app/secret/update.js +8 -9
  35. package/commands/app.js +8 -1
  36. package/commands/auth.js +13 -13
  37. package/commands/cms/app/create.js +9 -5
  38. package/commands/cms/convertFields.js +8 -8
  39. package/commands/cms/delete.js +2 -3
  40. package/commands/cms/fetch.js +7 -7
  41. package/commands/cms/function/create.js +9 -5
  42. package/commands/cms/function/deploy.js +2 -3
  43. package/commands/cms/function/list.js +11 -7
  44. package/commands/cms/function/logs.js +17 -23
  45. package/commands/cms/function/server.js +16 -10
  46. package/commands/cms/getReactModule.js +7 -8
  47. package/commands/cms/lighthouseScore.js +25 -24
  48. package/commands/cms/lint.js +4 -5
  49. package/commands/cms/list.js +5 -6
  50. package/commands/cms/module/create.js +15 -5
  51. package/commands/cms/module/marketplace-validate.js +7 -8
  52. package/commands/cms/mv.js +2 -3
  53. package/commands/cms/template/create.js +10 -6
  54. package/commands/cms/theme/create.js +5 -5
  55. package/commands/cms/theme/generate-selectors.js +5 -4
  56. package/commands/cms/theme/marketplace-validate.js +8 -9
  57. package/commands/cms/theme/preview.js +24 -9
  58. package/commands/cms/upload.js +15 -12
  59. package/commands/cms/watch.js +5 -5
  60. package/commands/cms/webpack/create.js +5 -5
  61. package/commands/completion.js +3 -5
  62. package/commands/config/migrate.js +6 -7
  63. package/commands/config/set.js +29 -11
  64. package/commands/customObject/create.js +4 -5
  65. package/commands/customObject/createSchema.js +6 -8
  66. package/commands/customObject/deleteSchema.js +4 -5
  67. package/commands/customObject/fetchAllSchemas.js +2 -3
  68. package/commands/customObject/fetchSchema.js +2 -3
  69. package/commands/customObject/listSchemas.js +2 -3
  70. package/commands/customObject/updateSchema.js +6 -8
  71. package/commands/doctor.js +8 -8
  72. package/commands/feedback.js +6 -4
  73. package/commands/filemanager/fetch.js +5 -6
  74. package/commands/filemanager/upload.js +5 -5
  75. package/commands/getStarted.js +34 -38
  76. package/commands/hubdb/clear.js +5 -6
  77. package/commands/hubdb/create.js +4 -5
  78. package/commands/hubdb/delete.js +8 -9
  79. package/commands/hubdb/fetch.js +5 -6
  80. package/commands/hubdb/list.d.ts +1 -1
  81. package/commands/hubdb/list.js +23 -22
  82. package/commands/init.js +17 -18
  83. package/commands/mcp/setup.d.ts +2 -0
  84. package/commands/mcp/setup.js +35 -8
  85. package/commands/mcp/start.js +2 -3
  86. package/commands/open.js +4 -5
  87. package/commands/project/add.d.ts +3 -2
  88. package/commands/project/add.js +26 -18
  89. package/commands/project/appInstallStatus.d.ts +5 -0
  90. package/commands/project/appInstallStatus.js +139 -0
  91. package/commands/project/create.d.ts +4 -2
  92. package/commands/project/create.js +64 -23
  93. package/commands/project/delete.d.ts +7 -0
  94. package/commands/project/delete.js +74 -0
  95. package/commands/project/deploy.d.ts +2 -1
  96. package/commands/project/deploy.js +72 -50
  97. package/commands/project/dev/index.d.ts +3 -3
  98. package/commands/project/dev/index.js +47 -90
  99. package/commands/project/dev/unifiedFlow.js +81 -22
  100. package/commands/project/download.d.ts +3 -2
  101. package/commands/project/download.js +26 -14
  102. package/commands/project/info.d.ts +5 -0
  103. package/commands/project/info.js +73 -0
  104. package/commands/project/installApp.d.ts +8 -0
  105. package/commands/project/installApp.js +185 -0
  106. package/commands/project/installDeps.js +17 -11
  107. package/commands/project/lint.js +57 -19
  108. package/commands/project/list.d.ts +3 -2
  109. package/commands/project/list.js +34 -15
  110. package/commands/project/listBuilds.d.ts +3 -2
  111. package/commands/project/listBuilds.js +50 -19
  112. package/commands/project/logs.js +7 -10
  113. package/commands/project/migrate.js +26 -31
  114. package/commands/project/open.js +20 -13
  115. package/commands/project/profile/add.d.ts +2 -1
  116. package/commands/project/profile/add.js +42 -13
  117. package/commands/project/profile/delete.d.ts +1 -1
  118. package/commands/project/profile/delete.js +23 -15
  119. package/commands/project/release/create.d.ts +8 -0
  120. package/commands/project/release/create.js +160 -0
  121. package/commands/project/release/info.d.ts +7 -0
  122. package/commands/project/release/info.js +148 -0
  123. package/commands/project/release/list.d.ts +7 -0
  124. package/commands/project/release/list.js +119 -0
  125. package/commands/project/release/preview.d.ts +9 -0
  126. package/commands/project/release/preview.js +167 -0
  127. package/commands/project/release.d.ts +3 -0
  128. package/commands/project/release.js +26 -0
  129. package/commands/project/updateDeps.js +15 -11
  130. package/commands/project/upload.d.ts +7 -1
  131. package/commands/project/upload.js +159 -35
  132. package/commands/project/validate.d.ts +3 -2
  133. package/commands/project/validate.js +73 -103
  134. package/commands/project/watch.js +27 -29
  135. package/commands/project.js +17 -4
  136. package/commands/sandbox/create.js +15 -15
  137. package/commands/sandbox/delete.js +15 -17
  138. package/commands/secret/addSecret.js +6 -7
  139. package/commands/secret/deleteSecret.js +5 -6
  140. package/commands/secret/listSecret.js +2 -3
  141. package/commands/secret/updateSecret.js +4 -5
  142. package/commands/testAccount/create.d.ts +3 -2
  143. package/commands/testAccount/create.js +29 -25
  144. package/commands/testAccount/createConfig.js +7 -8
  145. package/commands/testAccount/delete.js +27 -18
  146. package/commands/testAccount/importData.d.ts +1 -1
  147. package/commands/testAccount/importData.js +6 -7
  148. package/commands/upgrade.js +11 -10
  149. package/lang/en.d.ts +597 -52
  150. package/lang/en.js +637 -76
  151. package/lib/CLIWebSocketServer.d.ts +5 -3
  152. package/lib/CLIWebSocketServer.js +31 -4
  153. package/lib/accountAuth.d.ts +3 -1
  154. package/lib/accountAuth.js +45 -19
  155. package/lib/accountTargetDiscovery.d.ts +15 -0
  156. package/lib/accountTargetDiscovery.js +175 -0
  157. package/lib/api/usageTracking.d.ts +30 -0
  158. package/lib/api/usageTracking.js +11 -0
  159. package/lib/app/install.d.ts +22 -0
  160. package/lib/app/install.js +42 -0
  161. package/lib/app/logs.d.ts +38 -0
  162. package/lib/app/logs.js +225 -0
  163. package/lib/app/migrate.js +13 -7
  164. package/lib/app/urls.d.ts +2 -0
  165. package/lib/app/urls.js +7 -1
  166. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.d.ts +4 -0
  167. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.js +146 -0
  168. package/lib/buildAccount.js +4 -4
  169. package/lib/cms/serverlessDevRuntime.d.ts +1 -0
  170. package/lib/cms/serverlessDevRuntime.js +72 -0
  171. package/lib/commonOpts.js +6 -2
  172. package/lib/configOptions.d.ts +10 -10
  173. package/lib/configOptions.js +10 -11
  174. package/lib/constants.d.ts +14 -2
  175. package/lib/constants.js +16 -2
  176. package/lib/dependencyManagement.js +10 -17
  177. package/lib/doctor/Diagnosis.js +5 -5
  178. package/lib/doctor/DiagnosticInfoBuilder.d.ts +2 -2
  179. package/lib/doctor/DiagnosticInfoBuilder.js +8 -8
  180. package/lib/doctor/Doctor.d.ts +1 -0
  181. package/lib/doctor/Doctor.js +40 -16
  182. package/lib/errorHandlers/index.js +4 -3
  183. package/lib/errorHandlers/suppressError.js +4 -0
  184. package/lib/errors/ProjectErrors.d.ts +0 -6
  185. package/lib/errors/ProjectErrors.js +0 -12
  186. package/lib/errors/ProjectValidationError.d.ts +2 -1
  187. package/lib/errors/ProjectValidationError.js +3 -1
  188. package/lib/errors/PromptExitError.d.ts +4 -2
  189. package/lib/errors/PromptExitError.js +3 -0
  190. package/lib/filesystem.d.ts +6 -0
  191. package/lib/filesystem.js +9 -0
  192. package/lib/getStartedV2Actions.js +18 -21
  193. package/lib/hasFeature.js +1 -2
  194. package/lib/importData.js +3 -4
  195. package/lib/jsonOutput/accountAuth.d.ts +7 -0
  196. package/lib/jsonOutput/accountAuth.js +6 -0
  197. package/lib/jsonOutput/projectAdd.d.ts +9 -0
  198. package/lib/jsonOutput/projectAdd.js +10 -0
  199. package/lib/jsonOutput/projectAppInstallStatus.d.ts +14 -0
  200. package/lib/jsonOutput/projectAppInstallStatus.js +14 -0
  201. package/lib/jsonOutput/projectCreate.d.ts +8 -0
  202. package/lib/jsonOutput/projectCreate.js +7 -0
  203. package/lib/jsonOutput/projectDeploy.d.ts +5 -0
  204. package/lib/jsonOutput/projectDeploy.js +4 -0
  205. package/lib/jsonOutput/projectDownload.d.ts +7 -0
  206. package/lib/jsonOutput/projectDownload.js +6 -0
  207. package/lib/jsonOutput/projectInfo.d.ts +21 -0
  208. package/lib/jsonOutput/projectInfo.js +19 -0
  209. package/lib/jsonOutput/projectInstallApp.d.ts +11 -0
  210. package/lib/jsonOutput/projectInstallApp.js +10 -0
  211. package/lib/jsonOutput/projectList.d.ts +29 -0
  212. package/lib/jsonOutput/projectList.js +28 -0
  213. package/lib/jsonOutput/projectListBuilds.d.ts +75 -0
  214. package/lib/jsonOutput/projectListBuilds.js +65 -0
  215. package/lib/jsonOutput/projectRelease.d.ts +49 -0
  216. package/lib/jsonOutput/projectRelease.js +44 -0
  217. package/lib/jsonOutput/projectUpload.d.ts +29 -0
  218. package/lib/jsonOutput/projectUpload.js +23 -0
  219. package/lib/jsonOutput/projectValidate.d.ts +36 -0
  220. package/lib/jsonOutput/projectValidate.js +20 -0
  221. package/lib/jsonOutput/testAccountCreate.d.ts +7 -0
  222. package/lib/jsonOutput/testAccountCreate.js +6 -0
  223. package/lib/link/accountTableUtils.d.ts +10 -0
  224. package/lib/link/accountTableUtils.js +39 -0
  225. package/lib/link/index.d.ts +18 -0
  226. package/lib/link/index.js +185 -0
  227. package/lib/link/linkUtils.d.ts +5 -0
  228. package/lib/link/linkUtils.js +49 -0
  229. package/lib/link/prompts.d.ts +7 -0
  230. package/lib/link/prompts.js +126 -0
  231. package/lib/link/renderLinkedAccountsTable.d.ts +2 -0
  232. package/lib/link/renderLinkedAccountsTable.js +14 -0
  233. package/lib/link/warnIfLinkedDirectory.d.ts +1 -0
  234. package/lib/link/warnIfLinkedDirectory.js +9 -0
  235. package/lib/links.js +6 -5
  236. package/lib/mcp/clients.d.ts +13 -0
  237. package/lib/mcp/clients.js +62 -0
  238. package/lib/mcp/promotion.d.ts +3 -0
  239. package/lib/mcp/promotion.js +109 -0
  240. package/lib/mcp/setup.d.ts +8 -2
  241. package/lib/mcp/setup.js +134 -39
  242. package/lib/middleware/autoUpdateMiddleware.js +6 -3
  243. package/lib/middleware/commandTargetingUtils.js +1 -0
  244. package/lib/npm/npmCli.d.ts +1 -0
  245. package/lib/npm/npmCli.js +13 -0
  246. package/lib/npm/packageJson.js +1 -1
  247. package/lib/process.d.ts +1 -1
  248. package/lib/process.js +10 -3
  249. package/lib/projects/ProjectLogsManager.js +7 -7
  250. package/lib/projects/add/legacyAddComponent.d.ts +2 -1
  251. package/lib/projects/add/legacyAddComponent.js +3 -0
  252. package/lib/projects/add/v2AddComponent.d.ts +2 -1
  253. package/lib/projects/add/v2AddComponent.js +7 -1
  254. package/lib/projects/builds.d.ts +2 -0
  255. package/lib/projects/builds.js +22 -0
  256. package/lib/projects/config.d.ts +6 -5
  257. package/lib/projects/config.js +7 -38
  258. package/lib/projects/create/index.js +2 -2
  259. package/lib/projects/create/legacy.js +2 -2
  260. package/lib/projects/create/tracking.d.ts +1 -0
  261. package/lib/projects/create/tracking.js +27 -0
  262. package/lib/projects/create/v2.js +4 -4
  263. package/lib/projects/delete.d.ts +13 -0
  264. package/lib/projects/delete.js +206 -0
  265. package/lib/projects/deploy.d.ts +1 -1
  266. package/lib/projects/deploy.js +2 -2
  267. package/lib/projects/installApp.d.ts +58 -0
  268. package/lib/projects/installApp.js +283 -0
  269. package/lib/projects/localDev/AppDevModeInterface.d.ts +0 -3
  270. package/lib/projects/localDev/AppDevModeInterface.js +33 -55
  271. package/lib/projects/localDev/DevSessionManager.d.ts +8 -5
  272. package/lib/projects/localDev/DevSessionManager.js +35 -49
  273. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  274. package/lib/projects/localDev/LocalDevLogger.js +18 -0
  275. package/lib/projects/localDev/LocalDevProcess.d.ts +11 -1
  276. package/lib/projects/localDev/LocalDevProcess.js +104 -19
  277. package/lib/projects/localDev/LocalDevState.d.ts +9 -2
  278. package/lib/projects/localDev/LocalDevState.js +21 -1
  279. package/lib/projects/localDev/LocalDevWatcher.js +1 -1
  280. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +1 -0
  281. package/lib/projects/localDev/LocalDevWebsocketServer.js +24 -2
  282. package/lib/projects/localDev/UIExtensionsDevModeInterface.js +2 -0
  283. package/lib/projects/localDev/helpers/account.d.ts +1 -7
  284. package/lib/projects/localDev/helpers/account.js +8 -90
  285. package/lib/projects/localDev/helpers/process.d.ts +1 -1
  286. package/lib/projects/localDev/helpers/process.js +4 -10
  287. package/lib/projects/localDev/helpers/project.d.ts +8 -6
  288. package/lib/projects/localDev/helpers/project.js +80 -29
  289. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +2 -1
  290. package/lib/projects/localDev/localDevWebsocketServerUtils.js +3 -0
  291. package/lib/projects/npmAuditOnUpload.d.ts +10 -0
  292. package/lib/projects/npmAuditOnUpload.js +73 -0
  293. package/lib/projects/pollProjectBuildAndDeploy.d.ts +5 -1
  294. package/lib/projects/pollProjectBuildAndDeploy.js +3 -2
  295. package/lib/projects/preview.d.ts +7 -0
  296. package/lib/projects/preview.js +48 -0
  297. package/lib/projects/projectInfo.d.ts +5 -0
  298. package/lib/projects/projectInfo.js +82 -0
  299. package/lib/projects/projectProfiles.d.ts +3 -3
  300. package/lib/projects/projectProfiles.js +11 -18
  301. package/lib/projects/release.d.ts +4 -0
  302. package/lib/projects/release.js +90 -0
  303. package/lib/projects/ui.d.ts +1 -0
  304. package/lib/projects/ui.js +14 -0
  305. package/lib/projects/uieLinting.d.ts +23 -3
  306. package/lib/projects/uieLinting.js +134 -28
  307. package/lib/projects/upload.d.ts +17 -3
  308. package/lib/projects/upload.js +65 -14
  309. package/lib/projects/urls.d.ts +0 -1
  310. package/lib/projects/urls.js +6 -13
  311. package/lib/projects/validate.d.ts +18 -0
  312. package/lib/projects/validate.js +142 -0
  313. package/lib/projects/validateLintConfigOnUpload.d.ts +9 -0
  314. package/lib/projects/validateLintConfigOnUpload.js +46 -0
  315. package/lib/projects/workspaces.d.ts +60 -0
  316. package/lib/projects/workspaces.js +404 -0
  317. package/lib/prompts/createApiSamplePrompt.js +4 -0
  318. package/lib/prompts/personalAccessKeyPrompt.d.ts +2 -5
  319. package/lib/prompts/personalAccessKeyPrompt.js +7 -5
  320. package/lib/prompts/projectDevTargetAccountPrompt.d.ts +1 -0
  321. package/lib/prompts/projectDevTargetAccountPrompt.js +13 -2
  322. package/lib/prompts/projectProfilePrompt.d.ts +2 -0
  323. package/lib/prompts/projectProfilePrompt.js +46 -0
  324. package/lib/prompts/projectsLogsPrompt.js +3 -0
  325. package/lib/prompts/promptUtils.js +4 -2
  326. package/lib/prompts/selectAppPrompt.js +1 -0
  327. package/lib/prompts/selectHubDBTablePrompt.js +2 -2
  328. package/lib/prompts/selectPublicAppForMigrationPrompt.js +2 -2
  329. package/lib/prompts/setAsDefaultAccountPrompt.js +2 -1
  330. package/lib/serverlessLogs.js +2 -2
  331. package/lib/testUtils.d.ts +1 -0
  332. package/lib/testUtils.js +14 -0
  333. package/lib/theme/cmsDevServerProcess.d.ts +2 -0
  334. package/lib/theme/cmsDevServerProcess.js +8 -7
  335. package/lib/theme/migrate.js +1 -4
  336. package/lib/ui/SpinniesManager.d.ts +2 -0
  337. package/lib/ui/SpinniesManager.js +34 -10
  338. package/lib/ui/accountTable.d.ts +8 -0
  339. package/lib/ui/accountTable.js +67 -0
  340. package/lib/ui/appLogs.d.ts +32 -0
  341. package/lib/ui/appLogs.js +175 -0
  342. package/lib/ui/index.js +2 -2
  343. package/lib/ui/spinniesUtils.d.ts +0 -1
  344. package/lib/ui/spinniesUtils.js +6 -16
  345. package/lib/ui/supportsColor.d.ts +4 -0
  346. package/lib/ui/supportsColor.js +25 -6
  347. package/lib/usageTracking.d.ts +10 -20
  348. package/lib/usageTracking.js +77 -30
  349. package/lib/yargs/makeWrappedYargsHandler.d.ts +7 -0
  350. package/lib/yargs/makeWrappedYargsHandler.js +179 -0
  351. package/lib/yargs/makeYargsBuilder.d.ts +13 -0
  352. package/lib/yargs/makeYargsBuilder.js +33 -0
  353. package/lib/yargs/parseYargsOrExit.d.ts +4 -0
  354. package/lib/yargs/parseYargsOrExit.js +25 -0
  355. package/lib/yargs/strictEnforceBoolean.d.ts +1 -0
  356. package/lib/yargs/strictEnforceBoolean.js +13 -0
  357. package/lib/yargsUtils.d.ts +3 -16
  358. package/lib/yargsUtils.js +3 -48
  359. package/mcp-server/Tool.d.ts +25 -0
  360. package/mcp-server/Tool.js +83 -0
  361. package/mcp-server/server.js +63 -3
  362. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +5 -3
  363. package/mcp-server/tools/cms/HsCreateFunctionTool.js +18 -23
  364. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +5 -3
  365. package/mcp-server/tools/cms/HsCreateModuleTool.js +21 -26
  366. package/mcp-server/tools/cms/HsCreateTemplateTool.d.ts +5 -3
  367. package/mcp-server/tools/cms/HsCreateTemplateTool.js +16 -16
  368. package/mcp-server/tools/cms/HsFunctionLogsTool.d.ts +5 -3
  369. package/mcp-server/tools/cms/HsFunctionLogsTool.js +17 -16
  370. package/mcp-server/tools/cms/HsListFunctionsTool.d.ts +5 -3
  371. package/mcp-server/tools/cms/HsListFunctionsTool.js +15 -14
  372. package/mcp-server/tools/cms/HsListTool.d.ts +5 -3
  373. package/mcp-server/tools/cms/HsListTool.js +14 -16
  374. package/mcp-server/tools/index.d.ts +3 -2
  375. package/mcp-server/tools/index.js +28 -22
  376. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +8 -5
  377. package/mcp-server/tools/project/AddFeatureToProjectTool.js +38 -37
  378. package/mcp-server/tools/project/AuthAccountTool.d.ts +18 -0
  379. package/mcp-server/tools/project/AuthAccountTool.js +88 -0
  380. package/mcp-server/tools/project/CreateProjectTool.d.ts +8 -5
  381. package/mcp-server/tools/project/CreateProjectTool.js +33 -20
  382. package/mcp-server/tools/project/CreateTestAccountTool.d.ts +5 -3
  383. package/mcp-server/tools/project/CreateTestAccountTool.js +42 -31
  384. package/mcp-server/tools/project/DeployProjectTool.d.ts +5 -3
  385. package/mcp-server/tools/project/DeployProjectTool.js +23 -17
  386. package/mcp-server/tools/project/DocFetchTool.d.ts +5 -3
  387. package/mcp-server/tools/project/DocFetchTool.js +8 -6
  388. package/mcp-server/tools/project/DocsSearchTool.d.ts +9 -3
  389. package/mcp-server/tools/project/DocsSearchTool.js +39 -15
  390. package/mcp-server/tools/project/FindProjectsTool.d.ts +15 -0
  391. package/mcp-server/tools/project/FindProjectsTool.js +60 -0
  392. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +6 -3
  393. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +16 -13
  394. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +6 -3
  395. package/mcp-server/tools/project/GetApplicationInfoTool.js +19 -14
  396. package/mcp-server/tools/project/GetBuildLogsTool.d.ts +5 -3
  397. package/mcp-server/tools/project/GetBuildLogsTool.js +19 -14
  398. package/mcp-server/tools/project/GetBuildStatusTool.d.ts +6 -3
  399. package/mcp-server/tools/project/GetBuildStatusTool.js +58 -15
  400. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +6 -3
  401. package/mcp-server/tools/project/GetConfigValuesTool.js +20 -13
  402. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +5 -3
  403. package/mcp-server/tools/project/GuidedWalkthroughTool.js +4 -6
  404. package/mcp-server/tools/project/KnowledgeSearchTool.d.ts +29 -0
  405. package/mcp-server/tools/project/KnowledgeSearchTool.js +79 -0
  406. package/mcp-server/tools/project/UploadProjectTools.d.ts +5 -3
  407. package/mcp-server/tools/project/UploadProjectTools.js +28 -20
  408. package/mcp-server/tools/project/ValidateProjectTool.d.ts +5 -3
  409. package/mcp-server/tools/project/ValidateProjectTool.js +32 -13
  410. package/mcp-server/tools/project/constants.d.ts +4 -2
  411. package/mcp-server/tools/project/constants.js +5 -1
  412. package/mcp-server/types.d.ts +3 -8
  413. package/mcp-server/types.js +1 -13
  414. package/mcp-server/utils/command.d.ts +26 -2
  415. package/mcp-server/utils/command.js +75 -15
  416. package/mcp-server/utils/config.js +6 -0
  417. package/mcp-server/utils/content.d.ts +3 -2
  418. package/mcp-server/utils/content.js +6 -1
  419. package/mcp-server/utils/elicitation.d.ts +9 -0
  420. package/mcp-server/utils/elicitation.js +35 -0
  421. package/mcp-server/utils/json.d.ts +3 -0
  422. package/mcp-server/utils/json.js +29 -0
  423. package/mcp-server/utils/logger.d.ts +13 -0
  424. package/mcp-server/utils/logger.js +59 -0
  425. package/mcp-server/utils/toolUsageTracking.js +28 -11
  426. package/package.json +37 -28
  427. package/types/AccountTargets.d.ts +37 -0
  428. package/types/AccountTargets.js +12 -0
  429. package/types/Link.d.ts +32 -0
  430. package/types/Link.js +5 -0
  431. package/types/LocalDev.d.ts +15 -2
  432. package/types/PackageJson.d.ts +1 -0
  433. package/types/ProjectComponents.d.ts +2 -1
  434. package/types/Projects.d.ts +25 -5
  435. package/types/Prompts.d.ts +1 -0
  436. package/types/Yargs.d.ts +23 -2
  437. package/ui/components/ActionSection.d.ts +1 -1
  438. package/ui/components/InputField.d.ts +1 -1
  439. package/ui/components/SelectInput.d.ts +1 -1
  440. package/ui/components/StatusIcon.d.ts +1 -1
  441. package/ui/components/Table.d.ts +13 -13
  442. package/ui/components/getStarted/GetStartedFlow.d.ts +1 -1
  443. package/ui/components/getStarted/screens/InstallationScreen.d.ts +1 -1
  444. package/ui/components/getStarted/screens/ProjectSetupScreen.d.ts +1 -1
  445. package/ui/components/getStarted/screens/UploadScreen.d.ts +1 -1
  446. package/api/__tests__/migrate.test.d.ts +0 -1
  447. package/api/__tests__/migrate.test.js +0 -199
  448. package/commands/__tests__/account.test.d.ts +0 -1
  449. package/commands/__tests__/account.test.js +0 -69
  450. package/commands/__tests__/auth.test.d.ts +0 -1
  451. package/commands/__tests__/auth.test.js +0 -43
  452. package/commands/__tests__/cms.test.d.ts +0 -1
  453. package/commands/__tests__/cms.test.js +0 -87
  454. package/commands/__tests__/config.test.d.ts +0 -1
  455. package/commands/__tests__/config.test.js +0 -44
  456. package/commands/__tests__/customObject.test.d.ts +0 -1
  457. package/commands/__tests__/customObject.test.js +0 -68
  458. package/commands/__tests__/doctor.test.d.ts +0 -1
  459. package/commands/__tests__/doctor.test.js +0 -132
  460. package/commands/__tests__/feedback.test.d.ts +0 -1
  461. package/commands/__tests__/feedback.test.js +0 -24
  462. package/commands/__tests__/filemanager.test.d.ts +0 -1
  463. package/commands/__tests__/filemanager.test.js +0 -45
  464. package/commands/__tests__/getStarted.test.d.ts +0 -1
  465. package/commands/__tests__/getStarted.test.js +0 -173
  466. package/commands/__tests__/hubdb.test.d.ts +0 -1
  467. package/commands/__tests__/hubdb.test.js +0 -50
  468. package/commands/__tests__/init.test.d.ts +0 -1
  469. package/commands/__tests__/init.test.js +0 -42
  470. package/commands/__tests__/mcp.test.d.ts +0 -1
  471. package/commands/__tests__/mcp.test.js +0 -46
  472. package/commands/__tests__/open.test.d.ts +0 -1
  473. package/commands/__tests__/open.test.js +0 -58
  474. package/commands/__tests__/project.test.d.ts +0 -1
  475. package/commands/__tests__/project.test.js +0 -125
  476. package/commands/__tests__/sandbox.test.d.ts +0 -1
  477. package/commands/__tests__/sandbox.test.js +0 -44
  478. package/commands/__tests__/secret.test.d.ts +0 -1
  479. package/commands/__tests__/secret.test.js +0 -49
  480. package/commands/__tests__/testAccount.test.d.ts +0 -1
  481. package/commands/__tests__/testAccount.test.js +0 -57
  482. package/commands/__tests__/upgrade.test.d.ts +0 -1
  483. package/commands/__tests__/upgrade.test.js +0 -309
  484. package/commands/account/__tests__/auth.test.d.ts +0 -1
  485. package/commands/account/__tests__/auth.test.js +0 -206
  486. package/commands/account/__tests__/clean.test.d.ts +0 -1
  487. package/commands/account/__tests__/clean.test.js +0 -28
  488. package/commands/account/__tests__/createOverride.test.d.ts +0 -1
  489. package/commands/account/__tests__/createOverride.test.js +0 -32
  490. package/commands/account/__tests__/info.test.d.ts +0 -1
  491. package/commands/account/__tests__/info.test.js +0 -28
  492. package/commands/account/__tests__/list.test.d.ts +0 -1
  493. package/commands/account/__tests__/list.test.js +0 -153
  494. package/commands/account/__tests__/remove.test.d.ts +0 -1
  495. package/commands/account/__tests__/remove.test.js +0 -36
  496. package/commands/account/__tests__/removeOverride.d.ts +0 -1
  497. package/commands/account/__tests__/removeOverride.js +0 -25
  498. package/commands/account/__tests__/rename.test.d.ts +0 -1
  499. package/commands/account/__tests__/rename.test.js +0 -82
  500. package/commands/account/__tests__/use.test.d.ts +0 -1
  501. package/commands/account/__tests__/use.test.js +0 -170
  502. package/commands/app/__tests__/migrate.test.d.ts +0 -1
  503. package/commands/app/__tests__/migrate.test.js +0 -111
  504. package/commands/app/secret/__tests__/add.test.d.ts +0 -1
  505. package/commands/app/secret/__tests__/add.test.js +0 -140
  506. package/commands/app/secret/__tests__/delete.test.d.ts +0 -1
  507. package/commands/app/secret/__tests__/delete.test.js +0 -28
  508. package/commands/app/secret/__tests__/list.test.d.ts +0 -1
  509. package/commands/app/secret/__tests__/list.test.js +0 -25
  510. package/commands/app/secret/__tests__/update.test.d.ts +0 -1
  511. package/commands/app/secret/__tests__/update.test.js +0 -28
  512. package/commands/cms/__tests__/delete.test.d.ts +0 -1
  513. package/commands/cms/__tests__/delete.test.js +0 -39
  514. package/commands/cms/__tests__/fetch.test.d.ts +0 -1
  515. package/commands/cms/__tests__/fetch.test.js +0 -156
  516. package/commands/cms/__tests__/function.test.d.ts +0 -1
  517. package/commands/cms/__tests__/function.test.js +0 -50
  518. package/commands/cms/__tests__/lint.test.d.ts +0 -1
  519. package/commands/cms/__tests__/lint.test.js +0 -33
  520. package/commands/cms/__tests__/list.test.d.ts +0 -1
  521. package/commands/cms/__tests__/list.test.js +0 -42
  522. package/commands/cms/__tests__/module.test.d.ts +0 -1
  523. package/commands/cms/__tests__/module.test.js +0 -45
  524. package/commands/cms/__tests__/mv.test.d.ts +0 -1
  525. package/commands/cms/__tests__/mv.test.js +0 -46
  526. package/commands/cms/__tests__/theme.test.d.ts +0 -1
  527. package/commands/cms/__tests__/theme.test.js +0 -54
  528. package/commands/cms/__tests__/upload.test.d.ts +0 -1
  529. package/commands/cms/__tests__/upload.test.js +0 -312
  530. package/commands/cms/__tests__/watch.test.d.ts +0 -1
  531. package/commands/cms/__tests__/watch.test.js +0 -204
  532. package/commands/cms/function/__tests__/logs.test.d.ts +0 -1
  533. package/commands/cms/function/__tests__/logs.test.js +0 -70
  534. package/commands/cms/theme/__tests__/generate-selectors.test.d.ts +0 -1
  535. package/commands/cms/theme/__tests__/generate-selectors.test.js +0 -28
  536. package/commands/cms/theme/__tests__/marketplace-validate.test.d.ts +0 -1
  537. package/commands/cms/theme/__tests__/marketplace-validate.test.js +0 -36
  538. package/commands/cms/theme/__tests__/preview.test.d.ts +0 -1
  539. package/commands/cms/theme/__tests__/preview.test.js +0 -54
  540. package/commands/customObject/__tests__/create.test.d.ts +0 -1
  541. package/commands/customObject/__tests__/create.test.js +0 -40
  542. package/commands/customObject/__tests__/createSchema.test.d.ts +0 -1
  543. package/commands/customObject/__tests__/createSchema.test.js +0 -28
  544. package/commands/customObject/__tests__/deleteSchema.test.d.ts +0 -1
  545. package/commands/customObject/__tests__/deleteSchema.test.js +0 -42
  546. package/commands/customObject/__tests__/fetch-all-schemas.test.d.ts +0 -1
  547. package/commands/customObject/__tests__/fetch-all-schemas.test.js +0 -41
  548. package/commands/customObject/__tests__/fetchSchema.test.d.ts +0 -1
  549. package/commands/customObject/__tests__/fetchSchema.test.js +0 -45
  550. package/commands/customObject/__tests__/listSchemas.test.d.ts +0 -1
  551. package/commands/customObject/__tests__/listSchemas.test.js +0 -29
  552. package/commands/customObject/__tests__/updateSchema.test.d.ts +0 -1
  553. package/commands/customObject/__tests__/updateSchema.test.js +0 -40
  554. package/commands/filemanager/__tests__/fetch.test.d.ts +0 -1
  555. package/commands/filemanager/__tests__/fetch.test.js +0 -32
  556. package/commands/filemanager/__tests__/upload.test.d.ts +0 -1
  557. package/commands/filemanager/__tests__/upload.test.js +0 -191
  558. package/commands/hubdb/__tests__/clear.test.d.ts +0 -1
  559. package/commands/hubdb/__tests__/clear.test.js +0 -28
  560. package/commands/hubdb/__tests__/create.test.d.ts +0 -1
  561. package/commands/hubdb/__tests__/create.test.js +0 -28
  562. package/commands/hubdb/__tests__/delete.test.d.ts +0 -1
  563. package/commands/hubdb/__tests__/delete.test.js +0 -28
  564. package/commands/hubdb/__tests__/fetch.test.d.ts +0 -1
  565. package/commands/hubdb/__tests__/fetch.test.js +0 -28
  566. package/commands/hubdb/__tests__/list.test.d.ts +0 -1
  567. package/commands/hubdb/__tests__/list.test.js +0 -88
  568. package/commands/mcp/__tests__/setup.test.d.ts +0 -1
  569. package/commands/mcp/__tests__/setup.test.js +0 -26
  570. package/commands/mcp/__tests__/start.test.d.ts +0 -1
  571. package/commands/mcp/__tests__/start.test.js +0 -144
  572. package/commands/project/__tests__/add.test.d.ts +0 -1
  573. package/commands/project/__tests__/add.test.js +0 -107
  574. package/commands/project/__tests__/create.test.d.ts +0 -1
  575. package/commands/project/__tests__/create.test.js +0 -97
  576. package/commands/project/__tests__/deploy.test.d.ts +0 -1
  577. package/commands/project/__tests__/deploy.test.js +0 -307
  578. package/commands/project/__tests__/dev.test.d.ts +0 -1
  579. package/commands/project/__tests__/dev.test.js +0 -273
  580. package/commands/project/__tests__/devUnifiedFlow.test.d.ts +0 -1
  581. package/commands/project/__tests__/devUnifiedFlow.test.js +0 -434
  582. package/commands/project/__tests__/download.test.d.ts +0 -1
  583. package/commands/project/__tests__/download.test.js +0 -39
  584. package/commands/project/__tests__/installDeps.test.d.ts +0 -1
  585. package/commands/project/__tests__/installDeps.test.js +0 -140
  586. package/commands/project/__tests__/lint.test.d.ts +0 -1
  587. package/commands/project/__tests__/lint.test.js +0 -704
  588. package/commands/project/__tests__/list.test.d.ts +0 -1
  589. package/commands/project/__tests__/list.test.js +0 -31
  590. package/commands/project/__tests__/listBuilds.test.d.ts +0 -1
  591. package/commands/project/__tests__/listBuilds.test.js +0 -38
  592. package/commands/project/__tests__/logs.test.d.ts +0 -1
  593. package/commands/project/__tests__/logs.test.js +0 -202
  594. package/commands/project/__tests__/migrate.test.d.ts +0 -1
  595. package/commands/project/__tests__/migrate.test.js +0 -106
  596. package/commands/project/__tests__/open.test.d.ts +0 -1
  597. package/commands/project/__tests__/open.test.js +0 -39
  598. package/commands/project/__tests__/profile.test.d.ts +0 -1
  599. package/commands/project/__tests__/profile.test.js +0 -42
  600. package/commands/project/__tests__/updateDeps.test.d.ts +0 -1
  601. package/commands/project/__tests__/updateDeps.test.js +0 -140
  602. package/commands/project/__tests__/upload.test.d.ts +0 -1
  603. package/commands/project/__tests__/upload.test.js +0 -234
  604. package/commands/project/__tests__/validate.test.d.ts +0 -1
  605. package/commands/project/__tests__/validate.test.js +0 -381
  606. package/commands/project/__tests__/watch.test.d.ts +0 -1
  607. package/commands/project/__tests__/watch.test.js +0 -35
  608. package/commands/project/dev/deprecatedFlow.d.ts +0 -11
  609. package/commands/project/dev/deprecatedFlow.js +0 -135
  610. package/commands/sandbox/__tests__/create.test.d.ts +0 -1
  611. package/commands/sandbox/__tests__/create.test.js +0 -198
  612. package/commands/sandbox/__tests__/delete.test.d.ts +0 -1
  613. package/commands/sandbox/__tests__/delete.test.js +0 -31
  614. package/commands/secret/__tests__/addSecret.test.d.ts +0 -1
  615. package/commands/secret/__tests__/addSecret.test.js +0 -162
  616. package/commands/secret/__tests__/deleteSecret.test.d.ts +0 -1
  617. package/commands/secret/__tests__/deleteSecret.test.js +0 -41
  618. package/commands/secret/__tests__/listSecret.test.d.ts +0 -1
  619. package/commands/secret/__tests__/listSecret.test.js +0 -29
  620. package/commands/secret/__tests__/updateSecret.test.d.ts +0 -1
  621. package/commands/secret/__tests__/updateSecret.test.js +0 -29
  622. package/commands/testAccount/__tests__/create.test.d.ts +0 -1
  623. package/commands/testAccount/__tests__/create.test.js +0 -106
  624. package/commands/testAccount/__tests__/createConfig.test.d.ts +0 -1
  625. package/commands/testAccount/__tests__/createConfig.test.js +0 -32
  626. package/commands/testAccount/__tests__/delete.test.d.ts +0 -1
  627. package/commands/testAccount/__tests__/delete.test.js +0 -29
  628. package/commands/testAccount/__tests__/importData.test.d.ts +0 -1
  629. package/commands/testAccount/__tests__/importData.test.js +0 -92
  630. package/lib/__tests__/CLIWebSocketServer.test.d.ts +0 -1
  631. package/lib/__tests__/CLIWebSocketServer.test.js +0 -252
  632. package/lib/__tests__/accountAuth.test.d.ts +0 -1
  633. package/lib/__tests__/accountAuth.test.js +0 -258
  634. package/lib/__tests__/accountTypes.test.d.ts +0 -1
  635. package/lib/__tests__/accountTypes.test.js +0 -98
  636. package/lib/__tests__/buildAccount.test.d.ts +0 -1
  637. package/lib/__tests__/buildAccount.test.js +0 -211
  638. package/lib/__tests__/cliUpgradeUtils.test.d.ts +0 -1
  639. package/lib/__tests__/cliUpgradeUtils.test.js +0 -131
  640. package/lib/__tests__/commandSuggestion.test.d.ts +0 -1
  641. package/lib/__tests__/commandSuggestion.test.js +0 -121
  642. package/lib/__tests__/commonOpts.test.d.ts +0 -1
  643. package/lib/__tests__/commonOpts.test.js +0 -80
  644. package/lib/__tests__/dependencyManagement.test.d.ts +0 -1
  645. package/lib/__tests__/dependencyManagement.test.js +0 -1067
  646. package/lib/__tests__/developerTestAccounts.test.d.ts +0 -1
  647. package/lib/__tests__/developerTestAccounts.test.js +0 -156
  648. package/lib/__tests__/hasFeature.test.d.ts +0 -1
  649. package/lib/__tests__/hasFeature.test.js +0 -167
  650. package/lib/__tests__/http.test.d.ts +0 -1
  651. package/lib/__tests__/http.test.js +0 -40
  652. package/lib/__tests__/importData.test.d.ts +0 -1
  653. package/lib/__tests__/importData.test.js +0 -98
  654. package/lib/__tests__/npmCli.test.d.ts +0 -1
  655. package/lib/__tests__/npmCli.test.js +0 -84
  656. package/lib/__tests__/oauth.test.d.ts +0 -1
  657. package/lib/__tests__/oauth.test.js +0 -109
  658. package/lib/__tests__/parsing.test.d.ts +0 -1
  659. package/lib/__tests__/parsing.test.js +0 -34
  660. package/lib/__tests__/polling.test.d.ts +0 -1
  661. package/lib/__tests__/polling.test.js +0 -76
  662. package/lib/__tests__/process.test.d.ts +0 -1
  663. package/lib/__tests__/process.test.js +0 -89
  664. package/lib/__tests__/sandboxes.test.d.ts +0 -1
  665. package/lib/__tests__/sandboxes.test.js +0 -128
  666. package/lib/__tests__/serverlessLogs.test.d.ts +0 -1
  667. package/lib/__tests__/serverlessLogs.test.js +0 -163
  668. package/lib/__tests__/usageTracking.test.d.ts +0 -1
  669. package/lib/__tests__/usageTracking.test.js +0 -197
  670. package/lib/__tests__/validation.test.d.ts +0 -1
  671. package/lib/__tests__/validation.test.js +0 -143
  672. package/lib/__tests__/yargsUtils.test.d.ts +0 -1
  673. package/lib/__tests__/yargsUtils.test.js +0 -124
  674. package/lib/app/__tests__/migrate.test.d.ts +0 -1
  675. package/lib/app/__tests__/migrate.test.js +0 -638
  676. package/lib/doctor/__tests__/Diagnosis.test.d.ts +0 -1
  677. package/lib/doctor/__tests__/Diagnosis.test.js +0 -84
  678. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.d.ts +0 -1
  679. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js +0 -177
  680. package/lib/doctor/__tests__/Doctor.test.d.ts +0 -1
  681. package/lib/doctor/__tests__/Doctor.test.js +0 -560
  682. package/lib/errorHandlers/__tests__/index.test.d.ts +0 -1
  683. package/lib/errorHandlers/__tests__/index.test.js +0 -278
  684. package/lib/mcp/__tests__/setup.test.d.ts +0 -1
  685. package/lib/mcp/__tests__/setup.test.js +0 -523
  686. package/lib/middleware/__tests__/commandTargetingUtils.test.d.ts +0 -1
  687. package/lib/middleware/__tests__/commandTargetingUtils.test.js +0 -99
  688. package/lib/middleware/__tests__/configMiddleware.test.d.ts +0 -1
  689. package/lib/middleware/__tests__/configMiddleware.test.js +0 -118
  690. package/lib/middleware/__tests__/gitMiddleware.test.d.ts +0 -1
  691. package/lib/middleware/__tests__/gitMiddleware.test.js +0 -43
  692. package/lib/middleware/__tests__/requestMiddleware.test.d.ts +0 -1
  693. package/lib/middleware/__tests__/requestMiddleware.test.js +0 -15
  694. package/lib/middleware/__tests__/usageTrackingMiddleware.test.d.ts +0 -1
  695. package/lib/middleware/__tests__/usageTrackingMiddleware.test.js +0 -44
  696. package/lib/middleware/__tests__/yargsChecksMiddleware.test.d.ts +0 -1
  697. package/lib/middleware/__tests__/yargsChecksMiddleware.test.js +0 -39
  698. package/lib/projects/__tests__/AppDevModeInterface.test.d.ts +0 -1
  699. package/lib/projects/__tests__/AppDevModeInterface.test.js +0 -541
  700. package/lib/projects/__tests__/DevServerManager.test.d.ts +0 -1
  701. package/lib/projects/__tests__/DevServerManager.test.js +0 -185
  702. package/lib/projects/__tests__/DevSessionManager.test.d.ts +0 -1
  703. package/lib/projects/__tests__/DevSessionManager.test.js +0 -250
  704. package/lib/projects/__tests__/LocalDevProcess.test.d.ts +0 -1
  705. package/lib/projects/__tests__/LocalDevProcess.test.js +0 -481
  706. package/lib/projects/__tests__/LocalDevWebsocketServer.test.d.ts +0 -1
  707. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +0 -231
  708. package/lib/projects/__tests__/ProjectLogsManager.test.d.ts +0 -1
  709. package/lib/projects/__tests__/ProjectLogsManager.test.js +0 -302
  710. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.d.ts +0 -1
  711. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.js +0 -160
  712. package/lib/projects/__tests__/components.test.d.ts +0 -1
  713. package/lib/projects/__tests__/components.test.js +0 -440
  714. package/lib/projects/__tests__/deploy.test.d.ts +0 -1
  715. package/lib/projects/__tests__/deploy.test.js +0 -231
  716. package/lib/projects/__tests__/localDevProjectHelpers.test.d.ts +0 -1
  717. package/lib/projects/__tests__/localDevProjectHelpers.test.js +0 -120
  718. package/lib/projects/__tests__/platformVersion.test.d.ts +0 -1
  719. package/lib/projects/__tests__/platformVersion.test.js +0 -63
  720. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.d.ts +0 -1
  721. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.js +0 -328
  722. package/lib/projects/__tests__/projectProfiles.test.d.ts +0 -1
  723. package/lib/projects/__tests__/projectProfiles.test.js +0 -441
  724. package/lib/projects/__tests__/projects.test.d.ts +0 -1
  725. package/lib/projects/__tests__/projects.test.js +0 -58
  726. package/lib/projects/__tests__/structure.test.d.ts +0 -1
  727. package/lib/projects/__tests__/structure.test.js +0 -210
  728. package/lib/projects/__tests__/uieLinting.test.d.ts +0 -1
  729. package/lib/projects/__tests__/uieLinting.test.js +0 -631
  730. package/lib/projects/__tests__/upload.test.d.ts +0 -1
  731. package/lib/projects/__tests__/upload.test.js +0 -183
  732. package/lib/projects/add/__tests__/legacyAddComponent.test.d.ts +0 -1
  733. package/lib/projects/add/__tests__/legacyAddComponent.test.js +0 -245
  734. package/lib/projects/add/__tests__/v2AddComponent.test.d.ts +0 -1
  735. package/lib/projects/add/__tests__/v2AddComponent.test.js +0 -343
  736. package/lib/projects/create/__tests__/legacy.test.d.ts +0 -1
  737. package/lib/projects/create/__tests__/legacy.test.js +0 -72
  738. package/lib/projects/create/__tests__/v2.test.d.ts +0 -1
  739. package/lib/projects/create/__tests__/v2.test.js +0 -257
  740. package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts +0 -40
  741. package/lib/projects/localDev/DevServerManager_DEPRECATED.js +0 -128
  742. package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts +0 -59
  743. package/lib/projects/localDev/LocalDevManager_DEPRECATED.js +0 -387
  744. package/lib/projects/platformVersion.d.ts +0 -9
  745. package/lib/projects/platformVersion.js +0 -39
  746. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.d.ts +0 -1
  747. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.js +0 -157
  748. package/lib/prompts/__tests__/createFunctionPrompt.test.d.ts +0 -1
  749. package/lib/prompts/__tests__/createFunctionPrompt.test.js +0 -129
  750. package/lib/prompts/__tests__/createModulePrompt.test.d.ts +0 -1
  751. package/lib/prompts/__tests__/createModulePrompt.test.js +0 -187
  752. package/lib/prompts/__tests__/createTemplatePrompt.test.d.ts +0 -1
  753. package/lib/prompts/__tests__/createTemplatePrompt.test.js +0 -102
  754. package/lib/prompts/__tests__/downloadProjectPrompt.test.d.ts +0 -1
  755. package/lib/prompts/__tests__/downloadProjectPrompt.test.js +0 -31
  756. package/lib/prompts/__tests__/projectAddPrompt.test.d.ts +0 -1
  757. package/lib/prompts/__tests__/projectAddPrompt.test.js +0 -143
  758. package/lib/prompts/__tests__/projectsLogsPrompt.test.d.ts +0 -1
  759. package/lib/prompts/__tests__/projectsLogsPrompt.test.js +0 -37
  760. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.d.ts +0 -1
  761. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.js +0 -160
  762. package/lib/theme/__tests__/migrate.test.d.ts +0 -1
  763. package/lib/theme/__tests__/migrate.test.js +0 -247
  764. package/lib/ui/__tests__/SpinniesManager.test.d.ts +0 -1
  765. package/lib/ui/__tests__/SpinniesManager.test.js +0 -488
  766. package/lib/ui/__tests__/removeAnsiCodes.test.d.ts +0 -1
  767. package/lib/ui/__tests__/removeAnsiCodes.test.js +0 -84
  768. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.d.ts +0 -1
  769. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.js +0 -254
  770. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.d.ts +0 -1
  771. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.js +0 -227
  772. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.d.ts +0 -1
  773. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.js +0 -208
  774. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.d.ts +0 -1
  775. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js +0 -186
  776. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.d.ts +0 -1
  777. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.js +0 -124
  778. package/mcp-server/tools/cms/__tests__/HsListTool.test.d.ts +0 -1
  779. package/mcp-server/tools/cms/__tests__/HsListTool.test.js +0 -124
  780. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.d.ts +0 -1
  781. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js +0 -157
  782. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.d.ts +0 -1
  783. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js +0 -131
  784. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.d.ts +0 -1
  785. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.js +0 -461
  786. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.d.ts +0 -1
  787. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js +0 -125
  788. package/mcp-server/tools/project/__tests__/DocFetchTool.test.d.ts +0 -1
  789. package/mcp-server/tools/project/__tests__/DocFetchTool.test.js +0 -125
  790. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.d.ts +0 -1
  791. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +0 -210
  792. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +0 -1
  793. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +0 -146
  794. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +0 -1
  795. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +0 -124
  796. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.d.ts +0 -1
  797. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.js +0 -307
  798. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.d.ts +0 -1
  799. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.js +0 -242
  800. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.d.ts +0 -1
  801. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +0 -209
  802. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.d.ts +0 -1
  803. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.js +0 -158
  804. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.d.ts +0 -1
  805. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.js +0 -187
  806. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.d.ts +0 -1
  807. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.js +0 -118
  808. package/mcp-server/utils/__tests__/command.test.d.ts +0 -1
  809. package/mcp-server/utils/__tests__/command.test.js +0 -275
  810. package/mcp-server/utils/__tests__/content.test.d.ts +0 -1
  811. package/mcp-server/utils/__tests__/content.test.js +0 -164
  812. package/mcp-server/utils/__tests__/feedbackTracking.test.d.ts +0 -1
  813. package/mcp-server/utils/__tests__/feedbackTracking.test.js +0 -69
@@ -0,0 +1,179 @@
1
+ import os from 'os';
2
+ import path from 'path';
3
+ import { z } from 'zod';
4
+ import { getConfig } from '@hubspot/local-dev-lib/config';
5
+ import { getStateValue, setStateValue, } from '@hubspot/local-dev-lib/config/state';
6
+ import { STATE_FLAGS } from '@hubspot/local-dev-lib/constants/config';
7
+ import { logger as ldlLogger } from '@hubspot/local-dev-lib/logger';
8
+ import { trackCommandUsage as _trackCommandUsage } from '../usageTracking.js';
9
+ import { pkg } from '../jsonLoader.js';
10
+ import { uiLogger } from '../ui/logger.js';
11
+ import { lib } from '../../lang/en.js';
12
+ import { EXIT_CODES } from '../enums/exitCodes.js';
13
+ import { isPromptExitError } from '../errors/PromptExitError.js';
14
+ import { debugError } from '../errorHandlers/index.js';
15
+ import { MAX_LOG_FILES } from '../constants.js';
16
+ const HANDLER_LOG_DIR = path.join(os.homedir(), '.hscli', 'logs', 'cli');
17
+ function logUsageTrackingMessage(isJsonOutput) {
18
+ if (isJsonOutput) {
19
+ return;
20
+ }
21
+ try {
22
+ const config = getConfig();
23
+ if (config?.allowUsageTracking !== true) {
24
+ return;
25
+ }
26
+ const lastShownVersion = getStateValue(STATE_FLAGS.USAGE_TRACKING_MESSAGE_LAST_SHOW_VERSION);
27
+ if (lastShownVersion === pkg.version) {
28
+ return;
29
+ }
30
+ setStateValue(STATE_FLAGS.USAGE_TRACKING_MESSAGE_LAST_SHOW_VERSION, pkg.version);
31
+ uiLogger.info(lib.usageTracking.transparencyMessage);
32
+ }
33
+ catch (_e) {
34
+ return;
35
+ }
36
+ }
37
+ function createUsageTracker(trackingName, derivedAccountId) {
38
+ const startTime = Date.now();
39
+ const meta = {};
40
+ let fired = false;
41
+ const addMetadata = (newMeta) => {
42
+ Object.assign(meta, newMeta);
43
+ };
44
+ const track = async (successful) => {
45
+ if (fired) {
46
+ return;
47
+ }
48
+ fired = true;
49
+ try {
50
+ const { accountId: overrideAccountId, ...trackingMeta } = meta;
51
+ trackingMeta.successful = successful;
52
+ trackingMeta.executionTime = Date.now() - startTime;
53
+ await _trackCommandUsage(trackingName, trackingMeta, overrideAccountId ?? derivedAccountId);
54
+ }
55
+ catch (_e) { }
56
+ };
57
+ const onForcedExit = () => {
58
+ process.exit(EXIT_CODES.SUCCESS);
59
+ };
60
+ const onSigint = async () => {
61
+ process.removeListener('SIGINT', onSigint);
62
+ process.on('SIGINT', onForcedExit);
63
+ try {
64
+ await track(false);
65
+ }
66
+ catch (_e) { }
67
+ process.removeListener('SIGINT', onForcedExit);
68
+ process.exit(EXIT_CODES.SUCCESS);
69
+ };
70
+ process.on('SIGINT', onSigint);
71
+ const trackAndCleanup = async (successful) => {
72
+ await track(successful);
73
+ process.removeListener('SIGINT', onSigint);
74
+ process.removeListener('SIGINT', onForcedExit);
75
+ };
76
+ return { addMetadata, trackAndCleanup };
77
+ }
78
+ function createJsonOutputManager(isJsonOutput, schema) {
79
+ const data = {};
80
+ let emitted = false;
81
+ const add = (newData) => {
82
+ Object.assign(data, newData);
83
+ };
84
+ const emit = () => {
85
+ if (!emitted && isJsonOutput && Object.keys(data).length > 0) {
86
+ emitted = true;
87
+ if (schema) {
88
+ const result = schema.safeParse(data);
89
+ if (!result.success) {
90
+ uiLogger.json(data);
91
+ uiLogger.warn(lib.jsonSchema.validationFailed);
92
+ return false;
93
+ }
94
+ }
95
+ uiLogger.json(data);
96
+ }
97
+ return true;
98
+ };
99
+ return { add, emit };
100
+ }
101
+ function createLogFileWriter(trackingName, isJsonOutput) {
102
+ const writeLogFile = () => {
103
+ if (isJsonOutput) {
104
+ return null;
105
+ }
106
+ return ldlLogger.writeBufferedLogsToFile({
107
+ dir: HANDLER_LOG_DIR,
108
+ filenamePrefix: trackingName,
109
+ maxFiles: MAX_LOG_FILES,
110
+ });
111
+ };
112
+ const writeFailureLogFile = () => {
113
+ const savedPath = writeLogFile();
114
+ if (savedPath) {
115
+ uiLogger.log('');
116
+ uiLogger.error(lib.handlerLogFile.saved(savedPath));
117
+ }
118
+ };
119
+ return { writeLogFile, writeFailureLogFile };
120
+ }
121
+ export function makeWrappedYargsHandler(trackingName, handler, options) {
122
+ return async (args) => {
123
+ const wrappedHandlerArgs = args;
124
+ const isJsonOutput = Boolean(wrappedHandlerArgs.json || wrappedHandlerArgs.formatOutputAsJson);
125
+ const schema = options?.jsonOutputSchema;
126
+ const tracker = createUsageTracker(trackingName, args.derivedAccountId);
127
+ if (wrappedHandlerArgs.jsonSchema) {
128
+ if (schema) {
129
+ uiLogger.json(z.toJSONSchema(schema));
130
+ }
131
+ else {
132
+ uiLogger.json({ error: lib.jsonSchema.noSchemaForCommand });
133
+ }
134
+ await tracker.trackAndCleanup(true);
135
+ return process.exit(EXIT_CODES.SUCCESS);
136
+ }
137
+ const json = createJsonOutputManager(isJsonOutput, schema);
138
+ const logs = createLogFileWriter(trackingName, isJsonOutput);
139
+ wrappedHandlerArgs.addUsageMetadata = tracker.addMetadata;
140
+ wrappedHandlerArgs.addJsonOutput = json.add;
141
+ wrappedHandlerArgs.exit = async (code) => {
142
+ const jsonValid = json.emit();
143
+ const exitCode = !jsonValid && code === EXIT_CODES.SUCCESS ? EXIT_CODES.WARNING : code;
144
+ await tracker.trackAndCleanup(exitCode !== EXIT_CODES.ERROR);
145
+ if (exitCode === EXIT_CODES.ERROR) {
146
+ logs.writeFailureLogFile();
147
+ }
148
+ else {
149
+ logs.writeLogFile();
150
+ }
151
+ return process.exit(exitCode);
152
+ };
153
+ logUsageTrackingMessage(isJsonOutput);
154
+ try {
155
+ await handler(wrappedHandlerArgs);
156
+ }
157
+ catch (e) {
158
+ const isSuccessfulPromptExit = isPromptExitError(e)
159
+ ? e.exitCode !== EXIT_CODES.ERROR
160
+ : false;
161
+ await tracker.trackAndCleanup(isSuccessfulPromptExit);
162
+ if (isPromptExitError(e)) {
163
+ logs.writeLogFile();
164
+ return process.exit(e.exitCode);
165
+ }
166
+ else {
167
+ debugError(e);
168
+ logs.writeFailureLogFile();
169
+ return process.exit(EXIT_CODES.ERROR);
170
+ }
171
+ }
172
+ const jsonValid = json.emit();
173
+ await tracker.trackAndCleanup(true);
174
+ logs.writeLogFile();
175
+ if (!jsonValid) {
176
+ return process.exit(EXIT_CODES.WARNING);
177
+ }
178
+ };
179
+ }
@@ -0,0 +1,13 @@
1
+ import { Argv } from 'yargs';
2
+ export declare function makeYargsBuilder<T>(callback: (yargs: Argv) => Argv<T>, command: string | string[], describe?: string, options?: {
3
+ useGlobalOptions?: boolean;
4
+ useAccountOptions?: boolean;
5
+ useConfigOptions?: boolean;
6
+ useEnvironmentOptions?: boolean;
7
+ useTestingOptions?: boolean;
8
+ useCmsPublishModeOptions?: boolean | {
9
+ read?: boolean;
10
+ write?: boolean;
11
+ };
12
+ useJSONOutputOptions?: boolean;
13
+ }): (yargs: Argv) => Promise<Argv<T>>;
@@ -0,0 +1,33 @@
1
+ import { addCustomHelpOutput, addTestingOptions, addAccountOptions, addConfigOptions, addGlobalOptions, addUseEnvironmentOptions, addCmsPublishModeOptions, addJSONOutputOptions, } from '../commonOpts.js';
2
+ export function makeYargsBuilder(callback, command, describe, options = {}) {
3
+ return async function (yargs) {
4
+ if (options.useGlobalOptions) {
5
+ addGlobalOptions(yargs);
6
+ }
7
+ if (options.useAccountOptions) {
8
+ addAccountOptions(yargs);
9
+ }
10
+ if (options.useConfigOptions) {
11
+ addConfigOptions(yargs);
12
+ }
13
+ if (options.useEnvironmentOptions) {
14
+ addUseEnvironmentOptions(yargs);
15
+ }
16
+ if (options.useTestingOptions) {
17
+ addTestingOptions(yargs);
18
+ }
19
+ if (options.useJSONOutputOptions) {
20
+ addJSONOutputOptions(yargs);
21
+ }
22
+ if (options.useCmsPublishModeOptions) {
23
+ const opts = typeof options.useCmsPublishModeOptions === 'object'
24
+ ? options.useCmsPublishModeOptions
25
+ : { write: true };
26
+ addCmsPublishModeOptions(yargs, opts);
27
+ }
28
+ const result = callback(yargs);
29
+ // Must go last to pick up available options
30
+ await addCustomHelpOutput(result, command, describe);
31
+ return result;
32
+ };
33
+ }
@@ -0,0 +1,4 @@
1
+ import { ArgumentsCamelCase, Argv } from 'yargs';
2
+ type YargsFailureHandler<T> = (message: string | null, error: unknown, parser: Argv<T>) => never;
3
+ export declare function parseYargsOrExit<T>(parser: Argv<T>, handleFailure: YargsFailureHandler<T>): Promise<ArgumentsCamelCase<T>>;
4
+ export {};
@@ -0,0 +1,25 @@
1
+ function getYargsErrorMessage(error) {
2
+ return error instanceof Error && error.name === 'YError' ? error.message : '';
3
+ }
4
+ function getYargsFailureMessage(message, error) {
5
+ if (message) {
6
+ return message;
7
+ }
8
+ return getYargsErrorMessage(error) || message;
9
+ }
10
+ export async function parseYargsOrExit(parser, handleFailure) {
11
+ let failureHandled = false;
12
+ const parserWithFailureHandler = parser.fail((message, error, yargs) => {
13
+ failureHandled = true;
14
+ return handleFailure(getYargsFailureMessage(message, error), error, yargs);
15
+ });
16
+ try {
17
+ return await parserWithFailureHandler.parseAsync();
18
+ }
19
+ catch (error) {
20
+ if (failureHandled) {
21
+ throw error;
22
+ }
23
+ return handleFailure(getYargsErrorMessage(error), error, parserWithFailureHandler);
24
+ }
25
+ }
@@ -0,0 +1 @@
1
+ export declare function strictEnforceBoolean(rawArgs: string[], booleanOptions: string[]): boolean;
@@ -0,0 +1,13 @@
1
+ import { commands } from '../../lang/en.js';
2
+ export function strictEnforceBoolean(rawArgs, booleanOptions) {
3
+ for (const option of booleanOptions) {
4
+ const argIndex = rawArgs.findIndex(arg => arg.startsWith(`--${option}=`));
5
+ if (argIndex !== -1) {
6
+ const value = rawArgs[argIndex].split('=')[1];
7
+ if (value && !['true', 'false'].includes(value.toLowerCase())) {
8
+ throw new Error(commands.config.subcommands.set.errors.invalidBoolean(option, value));
9
+ }
10
+ }
11
+ }
12
+ return true;
13
+ }
@@ -1,16 +1,3 @@
1
- import { Argv } from 'yargs';
2
- import { hasFlag } from './utils/hasFlag.js';
3
- export { hasFlag };
4
- export declare function makeYargsBuilder<T>(callback: (yargs: Argv) => Argv<T>, command: string | string[], describe?: string, options?: {
5
- useGlobalOptions?: boolean;
6
- useAccountOptions?: boolean;
7
- useConfigOptions?: boolean;
8
- useEnvironmentOptions?: boolean;
9
- useTestingOptions?: boolean;
10
- useCmsPublishModeOptions?: boolean | {
11
- read?: boolean;
12
- write?: boolean;
13
- };
14
- useJSONOutputOptions?: boolean;
15
- }): (yargs: Argv) => Promise<Argv<T>>;
16
- export declare function strictEnforceBoolean(rawArgs: string[], booleanOptions: string[]): boolean;
1
+ export { hasFlag } from './utils/hasFlag.js';
2
+ export { makeYargsBuilder } from './yargs/makeYargsBuilder.js';
3
+ export { strictEnforceBoolean } from './yargs/strictEnforceBoolean.js';
package/lib/yargsUtils.js CHANGED
@@ -1,49 +1,4 @@
1
- import { addCustomHelpOutput, addTestingOptions, addAccountOptions, addConfigOptions, addGlobalOptions, addUseEnvironmentOptions, addCmsPublishModeOptions, addJSONOutputOptions, } from './commonOpts.js';
2
- import { hasFlag } from './utils/hasFlag.js';
3
- import { commands } from '../lang/en.js';
4
1
  // Re-export for backwards compatibility
5
- export { hasFlag };
6
- export function makeYargsBuilder(callback, command, describe, options = {}) {
7
- return async function (yargs) {
8
- if (options.useGlobalOptions) {
9
- addGlobalOptions(yargs);
10
- }
11
- if (options.useAccountOptions) {
12
- addAccountOptions(yargs);
13
- }
14
- if (options.useConfigOptions) {
15
- addConfigOptions(yargs);
16
- }
17
- if (options.useEnvironmentOptions) {
18
- addUseEnvironmentOptions(yargs);
19
- }
20
- if (options.useTestingOptions) {
21
- addTestingOptions(yargs);
22
- }
23
- if (options.useJSONOutputOptions) {
24
- addJSONOutputOptions(yargs);
25
- }
26
- if (options.useCmsPublishModeOptions) {
27
- const opts = typeof options.useCmsPublishModeOptions === 'object'
28
- ? options.useCmsPublishModeOptions
29
- : { write: true };
30
- addCmsPublishModeOptions(yargs, opts);
31
- }
32
- const result = callback(yargs);
33
- // Must go last to pick up available options
34
- await addCustomHelpOutput(result, command, describe);
35
- return result;
36
- };
37
- }
38
- export function strictEnforceBoolean(rawArgs, booleanOptions) {
39
- for (const option of booleanOptions) {
40
- const argIndex = rawArgs.findIndex(arg => arg.startsWith(`--${option}=`));
41
- if (argIndex !== -1) {
42
- const value = rawArgs[argIndex].split('=')[1];
43
- if (value && !['true', 'false'].includes(value.toLowerCase())) {
44
- throw new Error(commands.config.subcommands.set.errors.invalidBoolean(option, value));
45
- }
46
- }
47
- }
48
- return true;
49
- }
2
+ export { hasFlag } from './utils/hasFlag.js';
3
+ export { makeYargsBuilder } from './yargs/makeYargsBuilder.js';
4
+ export { strictEnforceBoolean } from './yargs/strictEnforceBoolean.js';
@@ -0,0 +1,25 @@
1
+ import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
3
+ import { ElicitResult, PrimitiveSchemaDefinition, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
4
+ import { McpLogger } from './utils/logger.js';
5
+ import { McpToolResponse } from './types.js';
6
+ import { CommandResults, Command } from './utils/command.js';
7
+ export type ToolExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
8
+ export declare class Tool<InputSchema> {
9
+ protected mcpServer: McpServer;
10
+ protected logger: McpLogger;
11
+ protected toolName: string;
12
+ constructor(mcpServer: McpServer, logger: McpLogger, toolName: string);
13
+ register(): RegisteredTool;
14
+ handler(_input: InputSchema): McpToolResponse | Promise<McpToolResponse>;
15
+ protected runCommand(directory: string, command: Command, extra?: ToolExtra): Promise<CommandResults>;
16
+ protected getTrackingMeta(_input: InputSchema): {
17
+ [key: string]: string;
18
+ } | undefined;
19
+ protected elicit(params: {
20
+ message: string;
21
+ fields: Record<string, PrimitiveSchemaDefinition>;
22
+ required?: string[];
23
+ }): Promise<ElicitResult | undefined>;
24
+ protected wrappedHandler(input: InputSchema, extra?: ToolExtra): Promise<McpToolResponse>;
25
+ }
@@ -0,0 +1,83 @@
1
+ import { formatErrorTextContents } from './utils/content.js';
2
+ import { getErrorMessage } from '../lib/errorHandlers/index.js';
3
+ import { trackToolUsage } from './utils/toolUsageTracking.js';
4
+ import { runCommandInDir } from './utils/command.js';
5
+ import { requestElicitation } from './utils/elicitation.js';
6
+ export class Tool {
7
+ mcpServer;
8
+ logger;
9
+ toolName;
10
+ constructor(mcpServer, logger, toolName) {
11
+ this.mcpServer = mcpServer;
12
+ this.logger = logger;
13
+ this.toolName = toolName;
14
+ }
15
+ register() {
16
+ throw new Error('Must implement register');
17
+ }
18
+ handler(_input) {
19
+ throw new Error('Must implement handler');
20
+ }
21
+ runCommand(directory, command, extra) {
22
+ let progressCount = 0;
23
+ return runCommandInDir(directory, command, async (chunk) => {
24
+ try {
25
+ const message = `${chunk.trimEnd()}`;
26
+ this.logger.debug(this.toolName, message);
27
+ const token = extra?._meta?.progressToken;
28
+ if (token !== undefined && extra?.sendNotification) {
29
+ progressCount++;
30
+ await extra.sendNotification({
31
+ method: 'notifications/progress',
32
+ params: {
33
+ progressToken: token,
34
+ progress: progressCount,
35
+ message,
36
+ },
37
+ });
38
+ }
39
+ }
40
+ catch {
41
+ // Swallow notification errors so a failed notification never crashes the tool
42
+ }
43
+ });
44
+ }
45
+ getTrackingMeta(_input) {
46
+ return undefined;
47
+ }
48
+ elicit(params) {
49
+ return requestElicitation(this.mcpServer, params, this.logger);
50
+ }
51
+ wrappedHandler(input, extra) {
52
+ return this.logger.runWithBuffer(async () => {
53
+ const startTime = Date.now();
54
+ try {
55
+ // `input` is logged unredacted. Tool input schemas MUST NOT include
56
+ // credentials or other sensitive values, since MCP clients (Claude
57
+ // Desktop, Inspector, etc.) will display these logs.
58
+ this.logger.debug(this.toolName, {
59
+ message: 'Tool invoked',
60
+ args: input,
61
+ });
62
+ await trackToolUsage(this.toolName, this.getTrackingMeta(input));
63
+ const result = await this.handler(input, extra);
64
+ this.logger.debug(this.toolName, {
65
+ message: 'Tool completed',
66
+ durationMs: Date.now() - startTime,
67
+ });
68
+ return result;
69
+ }
70
+ catch (error) {
71
+ this.logger.error(this.toolName, {
72
+ message: 'Tool failed',
73
+ error: error instanceof Error ? error.message : String(error),
74
+ durationMs: Date.now() - startTime,
75
+ });
76
+ return formatErrorTextContents(getErrorMessage(error));
77
+ }
78
+ finally {
79
+ this.logger.flushLogsToFile(this.toolName);
80
+ }
81
+ });
82
+ }
83
+ }
@@ -1,13 +1,73 @@
1
1
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
2
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
3
3
  import { registerProjectTools, registerCmsTools } from './tools/index.js';
4
+ import { McpLogger } from './utils/logger.js';
5
+ const instructions = `
6
+ This server exposes the HubSpot CLI (\`hs\`) for local development of HubSpot
7
+ projects, apps, and CMS assets. Prefer these tools over running \`hs\`,
8
+ \`npx hs\`, or HubSpot HTTP APIs directly via shell — they handle config
9
+ loading, auth, platform-version flags, and structured output for you.
10
+
11
+ WHEN TO USE THIS SERVER
12
+ - The user is working in a HubSpot project directory (has an hsproject.json
13
+ or *-hsmeta.json files), or wants to scaffold one.
14
+ - The user asks about HubSpot apps, CMS modules/templates/serverless
15
+ functions, project builds, deploys, or developer test accounts.
16
+ - The user asks a HubSpot platform/API question — answer it from the docs
17
+ via \`search-docs\` + \`fetch-doc\` rather than from prior knowledge.
18
+ - The user asks how to use HubSpot products or features, or about account
19
+ and subscription settings — answer it via \`search-knowledge-base\`
20
+ rather than from prior knowledge.
21
+
22
+ REQUIRED WORKFLOWS
23
+ 1. Authentication: call \`auth-account\` when the user wants to connect a
24
+ HubSpot account, when any tool reports "No account ID found", or when
25
+ there are no authenticated accounts. The tool opens a browser tab for
26
+ the user to authorize — no Personal Access Key is required up front.
27
+ 2. Documentation lookup: for developer APIs, SDKs, and platform reference,
28
+ call \`search-docs\` first, then \`fetch-doc\` on the most relevant
29
+ result(s). For HubSpot product, feature, or account and subscription
30
+ how-to questions, call \`search-knowledge-base\`. Answer from these
31
+ tools before planning, writing code, or answering. Do not answer from
32
+ memory.
33
+ 3. Locating a HubSpot project: when the current working directory is not
34
+ a HubSpot project (no \`hsproject.json\`) or you need to determine
35
+ whether a directory contains one, call \`find-projects\` before
36
+ running any tool that requires a project path.
37
+ 4. Editing \`*-hsmeta.json\`: call \`get-feature-config-schema\` for that
38
+ feature type first to learn the allowed fields and values.
39
+ 5. Debugging a failed build: start with \`get-build-status\` to surface
40
+ error messages, and only reach for \`get-build-logs\` for deeper
41
+ troubleshooting or warnings.
42
+ 6. Reading serverless function logs: call \`list-cms-serverless-functions\`
43
+ first to discover the endpoint path, then
44
+ \`get-cms-serverless-function-logs\`.
45
+ 7. Serverless functions come in two distinct kinds. CMS serverless
46
+ functions are website endpoints served at \`/hs/serverless/<path>\`.
47
+ Create them with \`create-cms-function\`, and manage them with
48
+ \`list-cms-serverless-functions\` and
49
+ \`get-cms-serverless-function-logs\`. App functions are serverless
50
+ functions built inside a developer-platform app, either private
51
+ (the \`app-function\` feature) or publicly accessible via an endpoint
52
+ (the \`app-function-endpoint\` feature). Create them with
53
+ \`add-feature-to-project\`. Do not use the CMS function tools for app
54
+ functions.
55
+ 8. App analytics: call \`get-apps-info\` to discover \`appId\` values
56
+ before \`get-api-usage-patterns-by-app-id\`.
57
+
58
+ OUTPUT
59
+ Tool results contain the relevant \`hs\` stdout/stderr or structured data.
60
+ Surface error text from results to the user verbatim when troubleshooting,
61
+ rather than paraphrasing.
62
+ `.trim();
4
63
  const server = new McpServer({
5
64
  name: 'HubSpot CLI MCP Server',
6
65
  version: '0.0.1',
7
66
  description: 'Helps perform tasks for local development of HubSpot projects.',
8
- });
9
- registerProjectTools(server);
10
- registerCmsTools(server);
67
+ }, { capabilities: { logging: {} }, instructions });
68
+ const logger = new McpLogger(server);
69
+ registerProjectTools(server, logger);
70
+ registerCmsTools(server, logger);
11
71
  // Start receiving messages on stdin and sending messages on stdout
12
72
  const transport = new StdioServerTransport();
13
73
  server.connect(transport);
@@ -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
  absoluteCurrentWorkingDirectory: z.ZodString;
@@ -17,8 +19,8 @@ declare const inputSchemaZodObject: z.ZodObject<{
17
19
  }, z.core.$strip>;
18
20
  export type HsCreateFunctionInputSchema = z.infer<typeof inputSchemaZodObject>;
19
21
  export declare class HsCreateFunctionTool extends Tool<HsCreateFunctionInputSchema> {
20
- constructor(mcpServer: McpServer);
21
- handler({ dest, functionsFolder, filename, endpointMethod, endpointPath, absoluteCurrentWorkingDirectory, }: HsCreateFunctionInputSchema): Promise<TextContentResponse>;
22
+ constructor(mcpServer: McpServer, logger: McpLogger);
23
+ handler({ dest, functionsFolder, filename, endpointMethod, endpointPath, absoluteCurrentWorkingDirectory, }: HsCreateFunctionInputSchema, extra?: ToolExtra): Promise<McpToolResponse>;
22
24
  register(): RegisteredTool;
23
25
  }
24
26
  export {};
@@ -1,11 +1,9 @@
1
- import { Tool } from '../../types.js';
1
+ import { Tool } from '../../Tool.js';
2
2
  import { z } from 'zod';
3
3
  import { absoluteCurrentWorkingDirectory } from '../project/constants.js';
4
- import { runCommandInDir } from '../../utils/command.js';
5
4
  import { formatTextContents, formatTextContent } from '../../utils/content.js';
6
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
7
- import { addFlag } from '../../utils/command.js';
8
5
  import { HTTP_METHODS } from '../../../types/Cms.js';
6
+ import { HubSpotCommand } from '../../utils/command.js';
9
7
  import { setupHubSpotConfig } from '../../utils/config.js';
10
8
  import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
11
9
  const inputSchema = {
@@ -35,12 +33,11 @@ const inputSchema = {
35
33
  const inputSchemaZodObject = z.object({ ...inputSchema });
36
34
  const toolName = 'create-cms-function';
37
35
  export class HsCreateFunctionTool extends Tool {
38
- constructor(mcpServer) {
39
- super(mcpServer);
36
+ constructor(mcpServer, logger) {
37
+ super(mcpServer, logger, toolName);
40
38
  }
41
- async handler({ dest, functionsFolder, filename, endpointMethod, endpointPath, absoluteCurrentWorkingDirectory, }) {
39
+ async handler({ dest, functionsFolder, filename, endpointMethod, endpointPath, absoluteCurrentWorkingDirectory, }, extra) {
42
40
  setupHubSpotConfig(absoluteCurrentWorkingDirectory);
43
- await trackToolUsage(toolName);
44
41
  const content = [];
45
42
  // Require functions folder
46
43
  if (!functionsFolder) {
@@ -61,38 +58,36 @@ export class HsCreateFunctionTool extends Tool {
61
58
  };
62
59
  }
63
60
  // Build the command
64
- let command = 'hs create function';
61
+ const command = new HubSpotCommand('cms function create');
65
62
  if (dest) {
66
- command += ` "${dest}"`;
63
+ command.addArg(dest);
67
64
  }
68
- // Add function-specific flags
69
65
  if (functionsFolder) {
70
- command = addFlag(command, 'functions-folder', functionsFolder);
66
+ command.addFlag('functions-folder', functionsFolder);
71
67
  }
72
68
  if (filename) {
73
- command = addFlag(command, 'filename', filename);
74
- }
75
- if (endpointMethod) {
76
- command = addFlag(command, 'endpoint-method', endpointMethod);
77
- }
78
- else {
79
- command = addFlag(command, 'endpoint-method', 'GET');
69
+ command.addFlag('filename', filename);
80
70
  }
71
+ command.addFlag('endpoint-method', endpointMethod ?? 'GET');
81
72
  if (endpointPath) {
82
- command = addFlag(command, 'endpoint-path', endpointPath);
73
+ command.addFlag('endpoint-path', endpointPath);
83
74
  }
84
75
  try {
85
- const { stdout, stderr } = await runCommandInDir(absoluteCurrentWorkingDirectory, command);
76
+ const { stdout, stderr } = await this.runCommand(absoluteCurrentWorkingDirectory, command, extra);
86
77
  return formatTextContents(stdout, stderr);
87
78
  }
88
79
  catch (error) {
80
+ this.logger.debug(toolName, {
81
+ message: 'Handler caught error',
82
+ error: error instanceof Error ? error.message : String(error),
83
+ });
89
84
  return formatTextContents(getErrorMessage(error));
90
85
  }
91
86
  }
92
87
  register() {
93
88
  return this.mcpServer.registerTool(toolName, {
94
89
  title: 'Create HubSpot CMS Serverless Function',
95
- description: `Creates a new HubSpot CMS serverless function using the hs create function command. Functions can be created non-interactively by specifying functionsFolder, filename, and endpointPath. Supports all HTTP methods (${HTTP_METHODS.join(', ')}).`,
90
+ description: `Creates a new HubSpot CMS serverless function using the hs cms function create command. This is for CMS/website projects, served at /hs/serverless/<path>. Do NOT use this for developer-platform app functions (the private app-function feature or the public app-function-endpoint feature). For those, use add-feature-to-project. Functions can be created non-interactively by specifying functionsFolder, filename, and endpointPath. Supports all HTTP methods (${HTTP_METHODS.join(', ')}).`,
96
91
  inputSchema,
97
92
  annotations: {
98
93
  readOnlyHint: false,
@@ -100,6 +95,6 @@ export class HsCreateFunctionTool extends Tool {
100
95
  idempotentHint: false,
101
96
  openWorldHint: false,
102
97
  },
103
- }, this.handler);
98
+ }, (input, extra) => this.wrappedHandler(input, extra));
104
99
  }
105
100
  }
@@ -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
  absoluteCurrentWorkingDirectory: z.ZodString;
@@ -13,8 +15,8 @@ declare const inputSchemaZodObject: z.ZodObject<{
13
15
  }, z.core.$strip>;
14
16
  export type HsCreateModuleInputSchema = z.infer<typeof inputSchemaZodObject>;
15
17
  export declare class HsCreateModuleTool extends Tool<HsCreateModuleInputSchema> {
16
- constructor(mcpServer: McpServer);
17
- handler({ userSuppliedName, dest, moduleLabel, reactType, contentTypes, global, availableForNewContent, absoluteCurrentWorkingDirectory, }: HsCreateModuleInputSchema): Promise<TextContentResponse>;
18
+ constructor(mcpServer: McpServer, logger: McpLogger);
19
+ handler({ userSuppliedName, dest, moduleLabel, reactType, contentTypes, global, availableForNewContent, absoluteCurrentWorkingDirectory, }: HsCreateModuleInputSchema, extra?: ToolExtra): Promise<McpToolResponse>;
18
20
  register(): RegisteredTool;
19
21
  }
20
22
  export {};