@hubspot/cli 8.10.0 → 8.12.0-beta.0

package/commands/testAccount/importData.d.ts

@@ -1,7 +1,7 @@
 import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, YargsCommandModule } from '../../types/Yargs.js';
 export declare const command = "import-data";
 export declare const describe: string;
-type CrmImportDataArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
+export type CrmImportDataArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
     filePath: string | undefined;
     skipConfirm: boolean | undefined;
 };

package/lang/en.d.ts

@@ -1330,11 +1330,18 @@ export declare const commands: {
             vsCode: string;
             args: {
                 client: string;
+                standalone: string;
+                cliVersion: string;
                 docsSearch: string;
             };
+            examples: {
+                nonInteractive: string;
+                standalone: string;
+            };
             success: (derivedTargets: string[]) => string;
             errors: {
                 errorParsingJsonFIle: (filename: string, errorMessage: string) => string;
+                cliVersionRequiresStandalone: string;
             };
             spinners: {
                 failedToConfigure: string;
@@ -1429,6 +1436,7 @@ export declare const commands: {
                 describe: string;
                 verboseDescribe: string;
                 example: string;
+                exampleCopyFrom: string;
                 logs: {
                     copyExistingProfile: (profileName: string) => string;
                     copyExistingProfiles: string;
@@ -1452,6 +1460,7 @@ export declare const commands: {
                     invalidTargetAccount: string;
                     noAccountsConfigured: string;
                     failedToLoadProfile: (profileName: string) => string;
+                    copyFromProfileNotFound: (profileName: string) => string;
                     failedToCreateProfile: string;
                 };
                 positionals: {
@@ -1459,6 +1468,7 @@ export declare const commands: {
                 };
                 options: {
                     targetAccount: string;
+                    copyFrom: string;
                 };
             };
             delete: {
@@ -1493,26 +1503,19 @@ export declare const commands: {
             describe: string;
             logs: {
                 header: string;
-                placeholderAccountSelection: string;
-                accountTypeInformation: string;
                 learnMoreMessageV2: string;
-                learnMoreMessageLegacy: string;
                 profileProjectAccountExplanation: (accountId: number, profileName: string) => string;
                 defaultProjectAccountExplanation: (accountId: number) => string;
                 projectAccountFlagExplanation: (accountId: number) => string;
-                accountFlagExplanation: (accountId: number) => string;
                 defaultSandboxOrDevTestTestingAccountExplanation: (accountId: number) => string;
                 testingAccountFlagExplanation: (accountId: number) => string;
             };
             errors: {
                 noProjectConfig: string;
                 noAccount: (accountId: number) => string;
-                noAccountsInConfig: string;
-                invalidProjectComponents: string;
+                unsupportedPlatformVersion: (platformVersion: string) => string;
                 noRunnableComponents: string;
                 accountNotCombined: string;
-                unsupportedAccountFlagLegacy: string;
-                unsupportedAccountFlagV2: string;
                 localDevAlreadyRunning: string;
             };
             examples: {
@@ -1525,7 +1528,6 @@ export declare const commands: {
                 profile: string;
                 projectAccount: string;
                 testingAccount: string;
-                account: string;
                 port: string;
             };
         };
@@ -1713,7 +1715,9 @@ export declare const commands: {
             errors: {
                 deploy: string;
                 noBuilds: string;
+                noSuccessfulBuilds: string;
                 noBuildId: string;
+                notSupportedForBuildVersion: string;
                 projectNotFound: (accountId: number, projectName: string) => string;
                 buildIdDoesNotExist: (accountId: number, buildId: number, projectName: string) => string;
                 buildAlreadyDeployed: (accountId: number, buildId: number, projectName: string) => string;
@@ -1744,11 +1748,20 @@ export declare const commands: {
                 confirmPrompt: (projectName: string, buildId: number) => string;
                 success: (releaseTag: string, buildId: number) => string;
                 cancelled: string;
+                buildIdPrompt: string;
+                noUploadMessage: string;
+                buildStatus: {
+                    BUILDING: string;
+                    FAILURE: string;
+                    PENDING: string;
+                    PREPARING: string;
+                };
+                uploadPrompt: (projectName: string) => string;
                 errors: {
                     projectNotFound: (accountId: number, projectName: string) => string;
-                    noDeployedBuild: string;
                     buildNotFound: (buildId: number, projectName: string) => string;
-                    buildNotDeployed: (buildId: number) => string;
+                    noSuccessfulBuilds: (projectName: string) => string;
+                    incompatibleBuildVersion: string;
                 };
                 options: {
                     build: string;
@@ -1880,6 +1893,8 @@ export declare const commands: {
                 readyToGoLive: string;
                 runCommand: (command: string) => string;
                 autoDeployDisabled: (deployCommand: string) => string;
+                autoDeploySkipped: (deployCommand: string) => string;
+                releaseManagementRequired: (releaseCommand: string) => string;
             };
             errors: {
                 noProjectConfig: string;
@@ -3330,6 +3345,10 @@ export declare const lib: {
     handlerLogFile: {
         saved: (filePath: string) => string;
     };
+    jsonSchema: {
+        noSchemaForCommand: string;
+        validationFailed: string;
+    };
     DevServerManager: {
         portConflict: (port: string) => string;
         notInitialized: string;
@@ -3475,19 +3494,6 @@ export declare const lib: {
             };
         };
         account: {
-            checkIfDefaultAccountIsSupported: {
-                publicApp: string;
-                privateApp: string;
-            };
-            validateAccountOption: {
-                invalidPublicAppAccount: string;
-                invalidPrivateAppAccount: string;
-                nonSandboxWarning: string;
-                publicAppNonDeveloperTestAccountWarning: string;
-            };
-            checkIfParentAccountIsAuthed: {
-                notAuthedError: (parentAccountId: number | string, accountIdentifier: string) => string;
-            };
             selectAccountTypePrompt: {
                 message: string;
                 developerTestAccountOption: string;
@@ -3495,10 +3501,7 @@ export declare const lib: {
                 sandboxAccountOptionDisabled: string;
                 productionAccountOption: (accountId?: number) => string;
             };
-            confirmDefaultAccountIsTarget: {
-                configError: string;
-                declineDefaultAccountExplanation: string;
-            };
+            declineDefaultAccountExplanation: string;
         };
     };
     middleware: {
@@ -3821,6 +3824,7 @@ export declare const lib: {
             qa: string;
             useEnv: string;
             jsonOutput: string;
+            jsonSchema: string;
             debug: string;
         };
     };

package/lang/en.js

@@ -1339,11 +1339,18 @@ export const commands = {
             vsCode: 'VSCode',
             args: {
                 client: 'Target apps to configure',
+                standalone: 'Use npx for all of the hs commands run by the MCP server. This allows you to use the MCP server without having the CLI globally installed.',
+                cliVersion: 'Pin a specific CLI version for standalone mode',
                 docsSearch: 'Should the docs search mcp server be installed',
             },
+            examples: {
+                nonInteractive: 'Configure Claude Code without prompts',
+                standalone: 'Configure Cursor in standalone mode with a pinned CLI version',
+            },
             success: (derivedTargets) => `You can now use the HubSpot CLI MCP Server in ${derivedTargets.join(', ')}.  ${chalk.bold('You may need to restart these tools to apply the changes')}.`,
             errors: {
                 errorParsingJsonFIle: (filename, errorMessage) => `Unable to update ${chalk.bold(filename)} due to invalid JSON: ${errorMessage}`,
+                cliVersionRequiresStandalone: '`--cli-version` requires `--standalone`. Pass `--standalone` to use a specific CLI version.',
             },
             spinners: {
                 failedToConfigure: 'Failed to configure the HubSpot mcp server.',
@@ -1444,6 +1451,7 @@ export const commands = {
                 describe: 'Add a new project profile',
                 verboseDescribe: `Add a new project profile\n\nProfiles enable you to reference variables in your component configuration files. Use the syntax ${chalk.bold('\${VARIABLE_NAME}')} to reference profile variables in your component configuration files. Then target the profile using the ${uiCommandReference('--profile')} flag when you upload your project.`,
                 example: 'Add a new project profile named hsprofile.qa.json',
+                exampleCopyFrom: 'Add a profile and copy variables from the staging profile',
                 logs: {
                     copyExistingProfile: (profileName) => `Found an existing profile. We can copy the variables from ${chalk.bold(profileName)} into your new profile.`,
                     copyExistingProfiles: 'We can copy the variables from one of your existing profiles into your new profile.',
@@ -1467,6 +1475,7 @@ export const commands = {
                     invalidTargetAccount: 'Target account is not configured in the CLI',
                     noAccountsConfigured: 'No accounts configured in the CLI',
                     failedToLoadProfile: (profileName) => `Unable to copy variables. Failed to load profile ${chalk.bold(profileName)}`,
+                    copyFromProfileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} does not exist. Available profiles can be found in your project source directory.`,
                     failedToCreateProfile: 'Failed to create profile',
                 },
                 positionals: {
@@ -1474,6 +1483,7 @@ export const commands = {
                 },
                 options: {
                     targetAccount: 'The target account ID for this profile',
+                    copyFrom: 'Copy variables from an existing profile',
                 },
             },
             delete: {
@@ -1508,26 +1518,19 @@ export const commands = {
             describe: 'Start local dev for the current project.',
             logs: {
                 header: 'HubSpot projects local development',
-                placeholderAccountSelection: 'Using default account as target account (for now)',
-                accountTypeInformation: 'Testing in a developer test account is strongly recommended, but you can use a sandbox account if your plan allows you to create one.',
                 learnMoreMessageV2: `Learn more about ${uiLink('HubSpot projects local dev', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server')} | ${uiLink('HubSpot account types', 'https://developers.hubspot.com/docs/getting-started/account-types')}`,
-                learnMoreMessageLegacy: uiLink('Learn more about the projects local dev server', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server'),
                 profileProjectAccountExplanation: (accountId, profileName) => `Using account ${uiAccountDescription(accountId)} from profile ${chalk.bold(profileName)} for project upload`,
                 defaultProjectAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for project upload`,
                 projectAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --project-account flag for project upload`,
-                accountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --account flag for project upload`,
                 defaultSandboxOrDevTestTestingAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for testing`,
                 testingAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --testing-account flag for testing`,
             },
             errors: {
                 noProjectConfig: 'No project detected. Please run this command again from a project directory.',
                 noAccount: (accountId) => `An error occurred while reading account ${uiAccountDescription(accountId)} from your config. Run ${uiAuthCommandReference()} to re-auth this account.`,
-                noAccountsInConfig: `No accounts found in your config. Run ${uiAuthCommandReference()} to configure a HubSpot account with the CLI.`,
-                invalidProjectComponents: 'Projects cannot contain both private and public apps. Move your apps to separate projects before attempting local development.',
+                unsupportedPlatformVersion: (platformVersion) => `Local development is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
                 noRunnableComponents: `No supported components were found in this project. Run ${uiCommandReference('hs project add')} to see a list of available components and add one to your project.`,
                 accountNotCombined: `\nLocal development of unified apps is currently only compatible with accounts that are opted into the unified apps beta. Make sure that this account is opted in or switch accounts using ${uiCommandReference('hs account use')}.`,
-                unsupportedAccountFlagLegacy: 'The --project-account and --testing-account flags are not supported for projects with platform versions earlier than 2025.2.',
-                unsupportedAccountFlagV2: 'The --account flag is not supported for projects with platform versions 2025.2 and newer. Use --testing-account and --project-account flags to specify accounts to use for local dev',
                 localDevAlreadyRunning: `Another ${uiCommandReference('hs project dev')} process is already running. To proceed with local development of this project, stop the existing process and re-run ${uiCommandReference('hs project dev')}.`,
             },
             examples: {
@@ -1538,9 +1541,8 @@ export const commands = {
             },
             options: {
                 profile: 'The profile to target during local dev',
-                projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account. Supported on platform versions 2025.2 and newer.',
-                testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account. Supported on platform versions 2025.2 and newer.',
-                account: 'The id of the account to upload your project to. Unsupported on platform versions 2025.2 and newer.',
+                projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account.',
+                testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account.',
                 port: `The port for the local dev server. Defaults to ${LOCAL_DEV_DEFAULT_PORT}.`,
             },
         },
@@ -1728,7 +1730,9 @@ export const commands = {
             errors: {
                 deploy: 'Deploy error: an unknown error occurred.',
                 noBuilds: 'Deploy error: no builds for this project were found.',
+                noSuccessfulBuilds: 'Deploy error: no successful builds for this project were found.',
                 noBuildId: 'You must specify a build to deploy',
+                notSupportedForBuildVersion: `This build's platform version does not support deploy. Run ${uiCommandReference('hs project release create')} to create a release instead.`,
                 projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
                 buildIdDoesNotExist: (accountId, buildId, projectName) => `Build ${buildId} does not exist for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds for this project.`,
                 buildAlreadyDeployed: (accountId, buildId, projectName) => `Build ${buildId} is already deployed. ${uiLink('View project builds in HubSpot', getProjectDetailUrl(projectName, accountId))}`,
@@ -1739,7 +1743,7 @@ export const commands = {
                 deployIssueComponentWarning: (uid, componentTypeName, message) => `- [${mapToUserFriendlyName(componentTypeName)}] ${chalk.bold('(' + uid + ')')} ${message}`,
             },
             examples: {
-                default: 'Deploy the latest build of the current project',
+                default: 'Deploy the last successful build of the current project',
                 withOptions: 'Deploy build 5 of the project my-project',
                 withProfile: 'Deploy using the provided profile',
             },
@@ -1748,29 +1752,38 @@ export const commands = {
                 project: 'Project name',
                 profile: 'The profile to target with this deploy',
                 force: 'Skip warnings and force deploy. Use this carefully as it will bypass warnings for destructive actions.',
-                deployLatestBuild: 'Deploy the latest build of the current project',
+                deployLatestBuild: 'Deploy the last successful build of the current project',
             },
         },
         release: {
             describe: 'Manage project releases.',
             create: {
                 describe: 'Create a release for a project build.',
-                verboseDescribe: `Create a release for a project build\n\nReleases mark a deployed build with an auto-generated semantic version tag (e.g. v1.0.0). The build must have been successfully deployed before it can be released.\n\nBy default, the latest deployed build is used. Use ${uiCommandReference('--build')} to specify a different build ID.`,
+                verboseDescribe: `Create a release for a project build\n\nReleases mark an uploaded build with an auto-generated semantic version tag (e.g. v1.0.0).\n\nBy default, the latest build is used. Use ${uiCommandReference('--build')} to specify a different build ID.`,
                 confirmPrompt: (projectName, buildId) => `Create a release for project ${chalk.bold(projectName)} using build ${chalk.bold(String(buildId))}?`,
                 success: (releaseTag, buildId) => `Release ${chalk.bold(releaseTag)} created for build ${chalk.bold(String(buildId))}.`,
                 cancelled: 'Release creation cancelled.',
+                buildIdPrompt: '[--build] Select a successful build to release:',
+                noUploadMessage: 'No upload message',
+                buildStatus: {
+                    BUILDING: 'Build in progress',
+                    FAILURE: 'Build failed',
+                    PENDING: 'Pending',
+                    PREPARING: 'Preparing',
+                },
+                uploadPrompt: (projectName) => `No successful builds for project ${chalk.bold(projectName)}. Would you like to upload it?`,
                 errors: {
                     projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
-                    noDeployedBuild: `No deployed build found for this project. Run ${uiCommandReference('hs project deploy')} first.`,
-                    buildNotFound: (buildId, projectName) => `Build ${chalk.bold(String(buildId))} was not found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds or ${uiCommandReference('hs project deploy')} to deploy a build first.`,
-                    buildNotDeployed: (buildId) => `Build ${chalk.bold(String(buildId))} has not been deployed. Run ${uiCommandReference('hs project deploy')} first.`,
+                    buildNotFound: (buildId, projectName) => `Build ${chalk.bold(String(buildId))} was not found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds or ${uiCommandReference('hs project upload')} to upload a build first.`,
+                    noSuccessfulBuilds: (projectName) => `No successful builds found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project upload')} to create a new build.`,
+                    incompatibleBuildVersion: `This build's platform version does not support releases. Upgrade your project to a newer platform version to use releases.`,
                 },
                 options: {
-                    build: 'Build ID to release. Defaults to the latest deployed build.',
-                    force: 'Skip confirmation prompt.',
+                    build: 'Build ID to release. Defaults to the latest build.',
+                    force: 'Skip all confirmation prompts, including automatic upload when no build exists.',
                 },
                 examples: {
-                    default: 'Create a release for the latest deployed build',
+                    default: 'Create a release for the latest build',
                     withBuild: 'Create a release for a specific build',
                 },
             },
@@ -1895,6 +1908,8 @@ export const commands = {
                 readyToGoLive: '🚀 Ready to take your project live?',
                 runCommand: (command) => `Run \`${uiCommandReference(command)}\``,
                 autoDeployDisabled: (deployCommand) => `Automatic deploys are disabled for this project. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
+                autoDeploySkipped: (deployCommand) => `Auto-deploy was skipped for this build. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
+                releaseManagementRequired: (releaseCommand) => `Run ${uiCommandReference(releaseCommand)} to create a release for this build.`,
             },
             errors: {
                 noProjectConfig: 'No project detected. Run this command from a project directory.',
@@ -3354,6 +3369,10 @@ export const lib = {
     handlerLogFile: {
         saved: (filePath) => `Debug logs can be viewed at ${filePath}`,
     },
+    jsonSchema: {
+        noSchemaForCommand: 'No schema defined for this command',
+        validationFailed: 'JSON output may be missing or malformed fields. The output schema may be out of date.',
+    },
     DevServerManager: {
         portConflict: (port) => `The port ${port} is already in use.`,
         notInitialized: 'The Dev Server Manager must be initialized before it is started.',
@@ -3511,19 +3530,6 @@ export const lib = {
             },
         },
         account: {
-            checkIfDefaultAccountIsSupported: {
-                publicApp: `This project contains a public app. Local development of public apps is only supported on developer accounts and developer test accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
-                privateApp: `This project contains a private app. Local development of private apps is not supported in developer accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
-            },
-            validateAccountOption: {
-                invalidPublicAppAccount: `This project contains a public app. The "--account" flag must point to a developer test account to develop this project locally. Alternatively, change your default account to an app developer account using ${uiCommandReference('hs account use')} and run ${uiCommandReference('hs project dev')} to set up a new developer test account.`,
-                invalidPrivateAppAccount: `This project contains a private app. The account specified with the "--account" flag points to a developer account, which do not support the local development of private apps. Update the "--account" flag to point to a standard, sandbox, or developer test account, or change your default account by running ${uiCommandReference('hs account use')}.`,
-                nonSandboxWarning: `Testing in a sandbox is strongly recommended. To switch the target account, select an option below or run ${uiCommandReference('hs account use')} before running the command again.`,
-                publicAppNonDeveloperTestAccountWarning: `Local development of public apps is only supported in ${chalk.bold('developer test accounts')}.`,
-            },
-            checkIfParentAccountIsAuthed: {
-                notAuthedError: (parentAccountId, accountIdentifier) => `To develop this project locally, run ${uiAuthCommandReference({ accountId: parentAccountId })} to authenticate the App Developer Account ${parentAccountId} associated with ${accountIdentifier}.`,
-            },
             selectAccountTypePrompt: {
                 message: 'Choose the type of account to test on',
                 developerTestAccountOption: 'Test on a developer test account (recommended)',
@@ -3531,10 +3537,7 @@ export const lib = {
                 sandboxAccountOptionDisabled: 'Disabled - requires access to sandbox accounts',
                 productionAccountOption: (accountId) => `<${chalk.red('!')} Test on your project account: ${uiAccountDescription(accountId, false)} ${chalk.red('!')}>`,
             },
-            confirmDefaultAccountIsTarget: {
-                configError: `An error occurred while reading the default account from your config. Run ${uiAuthCommandReference()} to re-auth this account`,
-                declineDefaultAccountExplanation: `To develop on a different account, run ${uiCommandReference('hs account use')} to change your default account, then re-run ${uiCommandReference('hs project dev')}.`,
-            },
+            declineDefaultAccountExplanation: `To develop on a different account, run ${uiCommandReference('hs account use')} to change your default account, then re-run ${uiCommandReference('hs project dev')}.`,
         },
     },
     middleware: {
@@ -3857,6 +3860,7 @@ export const lib = {
             qa: 'Run command in QA mode',
             useEnv: 'Use environment variable config',
             jsonOutput: 'Format output as JSON',
+            jsonSchema: 'Print the JSON output schema and exit',
             debug: 'Set log level to debug',
         },
     },

package/lib/commonOpts.js

@@ -72,11 +72,16 @@ export function addUseEnvironmentOptions(yargs) {
     return yargs;
 }
 export function addJSONOutputOptions(yargs) {
-    return yargs.option('json', {
+    yargs.option('json', {
         alias: 'format-output-as-json',
         describe: lib.commonOpts.options.jsonOutput,
         type: 'boolean',
     });
+    yargs.option('json-schema', {
+        describe: lib.commonOpts.options.jsonSchema,
+        type: 'boolean',
+    });
+    return yargs;
 }
 // Remove this once we've upgraded to yargs 18.0.0
 function uiBetaTagWithColor(message) {

package/lib/constants.d.ts

@@ -1,4 +1,5 @@
 export declare const HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH: "HubSpot/hubspot-project-components";
+export declare const MAX_LOG_FILES = 10;
 export declare const DEFAULT_PROJECT_TEMPLATE_BRANCH: "main";
 export declare const FEEDBACK_INTERVAL: 10;
 export declare const HUBSPOT_FOLDER: "@hubspot";

package/lib/constants.js

@@ -1,4 +1,5 @@
 export const HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH = 'HubSpot/hubspot-project-components';
+export const MAX_LOG_FILES = 10;
 export const DEFAULT_PROJECT_TEMPLATE_BRANCH = 'main';
 export const FEEDBACK_INTERVAL = 10;
 export const HUBSPOT_FOLDER = '@hubspot';

package/lib/jsonOutput.d.ts

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { Release } from '../api/releases.js';
+declare const ReleaseComponentSchema: z.ZodObject<{
+    buildType: z.ZodString;
+    buildName: z.ZodOptional<z.ZodString>;
+    rootPath: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReleaseSchema: z.ZodObject<{
+    releaseTag: z.ZodString;
+    buildId: z.ZodNumber;
+    createdAt: z.ZodString;
+    components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        buildType: z.ZodString;
+        buildName: z.ZodOptional<z.ZodString>;
+        rootPath: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ReleaseListSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        releaseTag: z.ZodString;
+        buildId: z.ZodNumber;
+        createdAt: z.ZodString;
+        components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            buildType: z.ZodString;
+            buildName: z.ZodOptional<z.ZodString>;
+            rootPath: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    paging: z.ZodOptional<z.ZodObject<{
+        next: z.ZodObject<{
+            after: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ProjectInfoSchema: z.ZodObject<{
+    projectName: z.ZodString;
+    platformVersion: z.ZodString;
+    projectId: z.ZodNumber;
+    deployedBuildId: z.ZodNumber;
+    autoDeployEnabled: z.ZodBoolean;
+    projectUrl: z.ZodOptional<z.ZodString>;
+    app: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        id: z.ZodNumber;
+        uid: z.ZodString;
+        authType: z.ZodOptional<z.ZodString>;
+        distributionType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    components: z.ZodArray<z.ZodObject<{
+        uid: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const PreviewSchema: z.ZodObject<{
+    releaseTag: z.ZodOptional<z.ZodString>;
+    succeeded: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const UploadSchema: z.ZodObject<{
+    buildId: z.ZodOptional<z.ZodNumber>;
+    deployId: z.ZodOptional<z.ZodNumber>;
+    preview: z.ZodOptional<z.ZodObject<{
+        releaseTag: z.ZodOptional<z.ZodString>;
+        succeeded: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const DeploySchema: z.ZodObject<{
+    deployId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const InstallStatusSchema: z.ZodObject<{
+    appId: z.ZodOptional<z.ZodNumber>;
+    appUid: z.ZodString;
+    accountId: z.ZodNumber;
+    projectId: z.ZodNumber;
+    isInstalled: z.ZodBoolean;
+    isInstalledWithCurrentScopes: z.ZodBoolean;
+    previouslyAuthorizedScopeGroups: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const InstallAppSchema: z.ZodObject<{
+    appId: z.ZodNumber;
+    appUid: z.ZodString;
+    accountId: z.ZodNumber;
+    projectId: z.ZodNumber;
+    installationState: z.ZodString;
+    installed: z.ZodBoolean;
+    reinstalled: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const CreateTestAccountSchema: z.ZodObject<{
+    accountName: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodNumber>;
+    personalAccessKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ReleaseComponentJsonOutput = z.infer<typeof ReleaseComponentSchema>;
+export type ReleaseJsonOutput = z.infer<typeof ReleaseSchema>;
+export type ReleaseListJsonOutput = z.infer<typeof ReleaseListSchema>;
+export type ProjectInfoJsonOutput = z.infer<typeof ProjectInfoSchema>;
+export type PreviewJsonOutput = z.infer<typeof PreviewSchema>;
+export type UploadJsonOutput = z.infer<typeof UploadSchema>;
+export type DeployJsonOutput = z.infer<typeof DeploySchema>;
+export type InstallStatusJsonOutput = z.infer<typeof InstallStatusSchema>;
+export type InstallAppJsonOutput = z.infer<typeof InstallAppSchema>;
+export type CreateTestAccountJsonOutput = z.infer<typeof CreateTestAccountSchema>;
+export declare function mapReleaseToJsonOutput(release: Release): ReleaseJsonOutput;
+export {};

package/lib/jsonOutput.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+const ReleaseComponentSchema = z.object({
+    buildType: z.string(),
+    buildName: z.string().optional(),
+    rootPath: z.string().optional(),
+    id: z.string().optional(),
+});
+export const ReleaseSchema = z.object({
+    releaseTag: z.string(),
+    buildId: z.number(),
+    createdAt: z.string(),
+    components: z.array(ReleaseComponentSchema).optional(),
+});
+export const ReleaseListSchema = z.object({
+    results: z.array(ReleaseSchema),
+    paging: z
+        .object({
+        next: z.object({
+            after: z.string(),
+        }),
+    })
+        .optional(),
+});
+export const ProjectInfoSchema = z.object({
+    projectName: z.string(),
+    platformVersion: z.string(),
+    projectId: z.number(),
+    deployedBuildId: z.number(),
+    autoDeployEnabled: z.boolean(),
+    projectUrl: z.string().optional(),
+    app: z
+        .object({
+        name: z.string(),
+        id: z.number(),
+        uid: z.string(),
+        authType: z.string().optional(),
+        distributionType: z.string().optional(),
+    })
+        .optional(),
+    components: z.array(z.object({ uid: z.string(), type: z.string() })),
+});
+const PreviewSchema = z.object({
+    releaseTag: z.string().optional(),
+    succeeded: z.boolean(),
+});
+export const UploadSchema = z.object({
+    buildId: z.number().optional(),
+    deployId: z.number().optional(),
+    preview: PreviewSchema.optional(),
+});
+export const DeploySchema = z.object({
+    deployId: z.number().optional(),
+});
+const ScopeGroupSchema = z.object({
+    id: z.number(),
+    name: z.string(),
+});
+export const InstallStatusSchema = z.object({
+    appId: z.number().optional(),
+    appUid: z.string(),
+    accountId: z.number(),
+    projectId: z.number(),
+    isInstalled: z.boolean(),
+    isInstalledWithCurrentScopes: z.boolean(),
+    previouslyAuthorizedScopeGroups: z.array(ScopeGroupSchema),
+});
+export const InstallAppSchema = z.object({
+    appId: z.number(),
+    appUid: z.string(),
+    accountId: z.number(),
+    projectId: z.number(),
+    installationState: z.string(),
+    installed: z.boolean(),
+    reinstalled: z.boolean(),
+});
+export const CreateTestAccountSchema = z.object({
+    accountName: z.string().optional(),
+    accountId: z.number().optional(),
+    personalAccessKey: z.string().optional(),
+});
+export function mapReleaseToJsonOutput(release) {
+    const { releaseTag, buildId, createdAt, components } = release;
+    return {
+        releaseTag,
+        buildId,
+        createdAt,
+        components: components?.map(({ buildType, buildName, rootPath, id }) => ({
+            buildType,
+            buildName,
+            rootPath,
+            id,
+        })),
+    };
+}

package/lib/mcp/setup.d.ts

@@ -8,7 +8,12 @@ interface McpCommand {
     args: string[];
     env?: Record<string, string>;
 }
-export declare function configureMcpServer(targets: string[] | undefined): Promise<string[]>;
+interface ConfigureMcpServerOptions {
+    targets?: string[];
+    standalone?: boolean;
+    cliVersion?: string;
+}
+export declare function configureMcpServer(options: ConfigureMcpServerOptions): Promise<string[]>;
 export declare function setupVsCode(mcpCommand?: McpCommand): Promise<boolean>;
 export declare function setupClaudeCode(mcpCommand?: McpCommand): Promise<boolean>;
 export declare function setupCursor(mcpCommand?: McpCommand): boolean;