@hubspot/cli 8.0.4-experimental.1 → 8.0.5-experimental.0

package/commands/cms/__tests__/upload.test.js

@@ -8,6 +8,7 @@ import * as modulesLib from '@hubspot/local-dev-lib/cms/modules';
 import * as ignoreRulesLib from '@hubspot/local-dev-lib/ignoreRules';
 import * as themesLib from '@hubspot/local-dev-lib/cms/themes';
 import * as configLib from '@hubspot/local-dev-lib/config';
+import * as handleFieldsJSLib from '@hubspot/local-dev-lib/cms/handleFieldsJS';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import * as errorHandlers from '../../../lib/errorHandlers/index.js';
 import * as commonOpts from '../../../lib/commonOpts.js';
@@ -26,6 +27,7 @@ vi.mock('@hubspot/local-dev-lib/cms/modules');
 vi.mock('@hubspot/local-dev-lib/ignoreRules');
 vi.mock('@hubspot/local-dev-lib/cms/themes');
 vi.mock('@hubspot/local-dev-lib/config');
+vi.mock('@hubspot/local-dev-lib/cms/handleFieldsJS');
 vi.mock('../../../lib/errorHandlers/index.js');
 vi.mock('../../../lib/commonOpts.js');
 vi.mock('../../../lib/prompts/uploadPrompt.js');
@@ -53,6 +55,7 @@ const hasUploadErrorsSpy = vi.spyOn(uploadFolderLib, 'hasUploadErrors');
 const processExitSpy = vi.spyOn(process, 'exit');
 const logErrorSpy = vi.spyOn(errorHandlers, 'logError');
 const getConfigAccountIfExistsSpy = vi.spyOn(configLib, 'getConfigAccountIfExists');
+const isConvertableFieldJsSpy = vi.spyOn(handleFieldsJSLib, 'isConvertableFieldJs');
 describe('commands/cms/upload', () => {
     beforeEach(() => {
         // @ts-expect-error Mock implementation
@@ -67,6 +70,7 @@ describe('commands/cms/upload', () => {
         getThemePreviewUrlSpy.mockReturnValue(undefined);
         // Mock config to prevent reading actual config file in CI
         getConfigAccountIfExistsSpy.mockReturnValue(undefined);
+        isConvertableFieldJsSpy.mockReturnValue(false);
     });
     describe('command', () => {
         it('should have the correct command structure', () => {

package/commands/project/__tests__/migrate.test.js

@@ -9,7 +9,7 @@ import { uiBetaTag, uiCommandReference } from '../../../lib/ui/index.js';
 vi.mock('../../../lib/app/migrate');
 vi.mock('../../../lib/projects/config');
 vi.mock('../../../lib/ui');
-const { v2025_2 } = PLATFORM_VERSIONS;
+const { v2025_2, v2026_3_beta } = PLATFORM_VERSIONS;
 describe('commands/project/migrate', () => {
     const yargsMock = yargs;
     const optionsSpy = vi.spyOn(yargsMock, 'option').mockReturnValue(yargsMock);
@@ -48,7 +48,7 @@ describe('commands/project/migrate', () => {
             migrateCommand.builder(yargsMock);
             expect(optionsSpy).toHaveBeenCalledWith('platform-version', {
                 type: 'string',
-                choices: [v2025_2],
+                choices: [v2025_2, v2026_3_beta],
                 default: v2025_2,
             });
             expect(optionsSpy).toHaveBeenCalledWith('unstable', {

package/commands/project/migrate.js

@@ -13,7 +13,7 @@ import { getHasMigratableThemes, migrateThemes2025_2, } from '../../lib/theme/mi
 import { hasFeature } from '../../lib/hasFeature.js';
 import { FEATURES } from '../../lib/constants.js';
 import { trackCommandMetadataUsage, trackCommandUsage, } from '../../lib/usageTracking.js';
-const { v2025_2 } = PLATFORM_VERSIONS;
+const { v2025_2, v2026_3_beta } = PLATFORM_VERSIONS;
 const command = 'migrate';
 const describe = commands.project.migrate.describe;
 async function handler(args) {
@@ -26,8 +26,8 @@ async function handler(args) {
     }
     if (projectConfig?.projectConfig) {
         await renderInline(getWarningBox({
-            title: lib.migrate.projectMigrationWarningTitle,
-            message: lib.migrate.projectMigrationWarning,
+            title: lib.migrate.projectMigrationWarningTitle(platformVersion),
+            message: lib.migrate.projectMigrationWarning(platformVersion),
         }));
     }
     try {
@@ -67,7 +67,7 @@ function projectMigrateBuilder(yargs) {
     yargs
         .option('platform-version', {
         type: 'string',
-        choices: [v2025_2],
+        choices: [v2025_2, v2026_3_beta],
         default: v2025_2,
     })
         .option('unstable', {

package/lang/en.d.ts

@@ -43,6 +43,11 @@ export declare const commands: {
             checkOutConfig: (configPath: string) => string;
             pressEnterToInstall: (accountName: string) => string;
             pressKeyToExit: string;
+            installingApp: (appName: string, accountName: string) => string;
+            installInstructions: string;
+            browserFailedToOpen: (url: string) => string;
+            pollingTimeout: (minutes: number) => string;
+            pressEnterToContinueSetup: string;
             prompts: {
                 selectOptionV2: string;
                 options: {
@@ -3918,8 +3923,8 @@ export declare const lib: {
         componentsToBeMigrated: (components: string) => string;
         componentsThatWillNotBeMigrated: (components: string) => string;
         sourceContentsMoved: (newLocation: string) => string;
-        projectMigrationWarningTitle: string;
-        projectMigrationWarning: string;
+        projectMigrationWarningTitle: (platformVersion: string) => string;
+        projectMigrationWarning: (platformVersion: string) => string;
         exitWithoutMigrating: string;
         success: {
             downloadedProject: (projectName: string, projectDest: string) => string;

package/lang/en.js

@@ -51,6 +51,11 @@ export const commands = {
             checkOutConfig: (configPath) => `Check out ${chalk.cyan(configPath)} for the full configuration.`,
             pressEnterToInstall: (accountName) => `? Press ${chalk.bold('<enter>')} to continue installing and previewing this app in ${chalk.bold(accountName)}`,
             pressKeyToExit: `Press any key to exit...`,
+            installingApp: (appName, accountName) => `Installing ${chalk.bold(appName)} in ${chalk.bold(accountName)}...`,
+            installInstructions: `We'll take you to your HubSpot account and walk you through installing your app.`,
+            browserFailedToOpen: (url) => `⚠️  Failed to open browser automatically. Please open this URL manually:\n${chalk.cyan(url)}`,
+            pollingTimeout: (minutes) => `⚠️  Installation polling timed out after ${minutes} minutes. The app may still be installing in the background.`,
+            pressEnterToContinueSetup: `Press ${chalk.bold('<enter>')} to continue with card setup...`,
             prompts: {
                 selectOptionV2: 'Choose a component type to get started',
                 options: {
@@ -3076,7 +3081,7 @@ export const lib = {
             updateSucceeded: (latestVersion) => `Successfully updated HubSpot CLI to version ${chalk.bold(latestVersion)}`,
             notInstalledGlobally: 'Cannot auto-update the HubSpot CLI because NPM is not installed globally',
             updateFailed: (latestVersion) => `Failed to update HubSpot CLI to version ${chalk.bold(latestVersion)}`,
-            enableAutoUpdatesMessage: `The HubSpot CLI can automatically keep itself up to date.\n\nThis helps ensure compatibility with the HubSpot platform. You can change this later at any time.\n\nRun${uiCommandReference('hs config set --allow-auto-updates=true')}`,
+            enableAutoUpdatesMessage: `The HubSpot CLI can automatically keep itself up to date.\n\nThis helps ensure compatibility with the HubSpot platform. You can change this later at any time.\n\nRun ${uiCommandReference('hs config set --allow-auto-updates=true')}`,
         },
     },
     projectProfiles: {
@@ -3941,8 +3946,8 @@ export const lib = {
         componentsToBeMigrated: (components) => `The following features will be migrated: ${components}`,
         componentsThatWillNotBeMigrated: (components) => `[NOTE] These features are not yet supported for migration but will be available later: ${components}`,
         sourceContentsMoved: (newLocation) => `The contents of your old source directory have been moved to ${newLocation}, move any required files to the new source directory.`,
-        projectMigrationWarningTitle: 'Important: Migrating to platformVersion 2025.2 is irreversible',
-        projectMigrationWarning: uiBetaTag(`Running the ${uiCommandReference('hs project migrate')} command will permanently upgrade your project to platformVersion 2025.2. This action cannot be undone. To ensure you have access to your original files, they will be copied to a new directory (archive) for safekeeping.\n\nThis command will guide you through the process, prompting you to enter the required fields and will download the new project source code into your project source directory.`, false),
+        projectMigrationWarningTitle: (platformVersion) => `Important: Migrating to platformVersion ${platformVersion} is irreversible`,
+        projectMigrationWarning: (platformVersion) => uiBetaTag(`Running the ${uiCommandReference('hs project migrate')} command will permanently upgrade your project to platformVersion ${platformVersion}. This action cannot be undone. To ensure you have access to your original files, they will be copied to a new directory (archive) for safekeeping.\n\nThis command will guide you through the process, prompting you to enter the required fields and will download the new project source code into your project source directory.`, false),
         exitWithoutMigrating: 'Exiting without migrating',
         success: {
             downloadedProject: (projectName, projectDest) => `Saved ${projectName} to ${projectDest}`,

package/lib/getStartedV2Actions.d.ts

@@ -35,3 +35,16 @@ export declare function uploadAndDeployAction({ accountId, projectDest, }: {
     projectDest: string;
 }): Promise<UploadAndDeployResult>;
 export declare function trackGetStartedUsage(params: Record<string, unknown>, accountId: number): Promise<void>;
+export type PollAppInstallationOptions = {
+    accountId: number;
+    projectId: number;
+    appUid: string;
+    requiredScopes?: string[];
+    optionalScopes?: string[];
+    timeoutMs?: number;
+    intervalMs?: number;
+    onTimeout?: () => void;
+};
+export declare function pollAppInstallation({ accountId, projectId, appUid, requiredScopes, optionalScopes, timeoutMs, // 2 minutes
+intervalMs, // 2 seconds
+onTimeout, }: PollAppInstallationOptions): Promise<void>;

package/lib/getStartedV2Actions.js

@@ -1,6 +1,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { fetchPublicAppsForPortal } from '@hubspot/local-dev-lib/api/appsDev';
+import { fetchAppInstallationData } from '@hubspot/local-dev-lib/api/localDevAuth';
 import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
@@ -144,3 +145,55 @@ export async function uploadAndDeployAction({ accountId, projectDest, }) {
 export function trackGetStartedUsage(params, accountId) {
     return trackCommandMetadataUsage('get-started', params, accountId);
 }
+export async function pollAppInstallation({ accountId, projectId, appUid, requiredScopes = [], optionalScopes = [], timeoutMs = 2 * 60 * 1000, // 2 minutes
+intervalMs = 2000, // 2 seconds
+onTimeout, }) {
+    return new Promise((resolve, reject) => {
+        let consecutiveErrors = 0;
+        const MAX_CONSECUTIVE_ERRORS = 5;
+        let pollInterval = null;
+        let pollTimeout = null;
+        const cleanup = () => {
+            if (pollInterval) {
+                clearTimeout(pollInterval);
+                pollInterval = null;
+            }
+            if (pollTimeout) {
+                clearTimeout(pollTimeout);
+                pollTimeout = null;
+            }
+        };
+        pollTimeout = setTimeout(() => {
+            cleanup();
+            if (onTimeout) {
+                onTimeout();
+            }
+            resolve(); // Resolve instead of reject to allow continuing with timeout state
+        }, timeoutMs);
+        const poll = async () => {
+            try {
+                const { data } = await fetchAppInstallationData(accountId, projectId, appUid, requiredScopes, optionalScopes);
+                // Reset error counter on successful fetch
+                consecutiveErrors = 0;
+                if (data.isInstalledWithScopeGroups) {
+                    cleanup();
+                    resolve();
+                }
+                else if (pollInterval) {
+                    pollInterval = setTimeout(poll, intervalMs);
+                }
+            }
+            catch (error) {
+                consecutiveErrors++;
+                if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
+                    cleanup();
+                    reject(new Error(`Failed to check app installation status after ${MAX_CONSECUTIVE_ERRORS} consecutive errors`, { cause: error }));
+                }
+                else if (pollInterval !== null) {
+                    pollInterval = setTimeout(poll, intervalMs);
+                }
+            }
+        };
+        pollInterval = setTimeout(poll, 0);
+    });
+}

package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts

@@ -5,9 +5,26 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     addApp: z.ZodBoolean;
-    distribution: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"marketplace">, z.ZodLiteral<"private">]>>;
-    auth: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"static">, z.ZodLiteral<"oauth">]>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+    distribution: z.ZodOptional<z.ZodEnum<{
+        marketplace: "marketplace";
+        private: "private";
+    }>>;
+    auth: z.ZodOptional<z.ZodEnum<{
+        oauth: "oauth";
+        static: "static";
+    }>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        card: "card";
+        settings: "settings";
+        "app-event": "app-event";
+        page: "page";
+        "workflow-action-tool": "workflow-action-tool";
+        webhooks: "webhooks";
+        "workflow-action": "workflow-action";
+        "app-function": "app-function";
+        "app-object": "app-object";
+        scim: "scim";
+    }>>>;
 }, z.core.$strip>;
 export type AddFeatureInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class AddFeatureToProjectTool extends Tool<AddFeatureInputSchema> {

package/mcp-server/tools/project/AddFeatureToProjectTool.js

@@ -15,17 +15,13 @@ const inputSchema = {
         .boolean()
         .describe('Should an app be added?  If there is no app in the project, an app must be added to add a feature'),
     distribution: z
-        .optional(z.union([
-        z.literal(APP_DISTRIBUTION_TYPES.MARKETPLACE),
-        z.literal(APP_DISTRIBUTION_TYPES.PRIVATE),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. '),
+        .enum([APP_DISTRIBUTION_TYPES.MARKETPLACE, APP_DISTRIBUTION_TYPES.PRIVATE])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. ')
+        .optional(),
     auth: z
-        .optional(z.union([
-        z.literal(APP_AUTH_TYPES.STATIC),
-        z.literal(APP_AUTH_TYPES.OAUTH),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. '),
+        .enum([APP_AUTH_TYPES.STATIC, APP_AUTH_TYPES.OAUTH])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. ')
+        .optional(),
     features,
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/mcp-server/tools/project/CreateProjectTool.d.ts

@@ -5,10 +5,30 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteCurrentWorkingDirectory: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
     destination: z.ZodString;
-    projectBase: z.ZodUnion<readonly [z.ZodLiteral<"empty">, z.ZodLiteral<"app">]>;
-    distribution: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"marketplace">, z.ZodLiteral<"private">]>>;
-    auth: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"static">, z.ZodLiteral<"oauth">]>>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+    projectBase: z.ZodEnum<{
+        app: "app";
+        empty: "empty";
+    }>;
+    distribution: z.ZodOptional<z.ZodEnum<{
+        marketplace: "marketplace";
+        private: "private";
+    }>>;
+    auth: z.ZodOptional<z.ZodEnum<{
+        oauth: "oauth";
+        static: "static";
+    }>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        card: "card";
+        settings: "settings";
+        "app-event": "app-event";
+        page: "page";
+        "workflow-action-tool": "workflow-action-tool";
+        webhooks: "webhooks";
+        "workflow-action": "workflow-action";
+        "app-function": "app-function";
+        "app-object": "app-object";
+        scim: "scim";
+    }>>>;
 }, z.core.$strip>;
 export type CreateProjectInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class CreateProjectTool extends Tool<CreateProjectInputSchema> {

package/mcp-server/tools/project/CreateProjectTool.js

@@ -18,19 +18,14 @@ const inputSchema = {
         .string()
         .describe('DO NOT use the current directory unless the user has explicitly stated to do so. Relative path to the directory the project will be created in.'),
     projectBase: z
-        .union([z.literal(EMPTY_PROJECT), z.literal(PROJECT_WITH_APP)])
+        .enum([EMPTY_PROJECT, PROJECT_WITH_APP])
         .describe('Empty will create an empty project, and app will create a project with an app inside of it.'),
     distribution: z
-        .optional(z.union([
-        z.literal(APP_DISTRIBUTION_TYPES.MARKETPLACE),
-        z.literal(APP_DISTRIBUTION_TYPES.PRIVATE),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. '),
+        .enum([APP_DISTRIBUTION_TYPES.MARKETPLACE, APP_DISTRIBUTION_TYPES.PRIVATE])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. ')
+        .optional(),
     auth: z
-        .optional(z.union([
-        z.literal(APP_AUTH_TYPES.STATIC),
-        z.literal(APP_AUTH_TYPES.OAUTH),
-    ]))
+        .enum([APP_AUTH_TYPES.STATIC, APP_AUTH_TYPES.OAUTH])
         .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. ')
         .optional(),
     features,

package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js

@@ -12,18 +12,15 @@ const inputSchema = {
     absoluteCurrentWorkingDirectory,
     appId: z
         .string()
-        .regex(/^\d+$/, 'App ID must be a numeric string')
-        .describe('The numeric app ID as a string (e.g., "3003909"). Use get-apps-info to find available app IDs.'),
+        .describe('The numeric app ID as a string (e.g., "3003909"). Must contain only digits. Use get-apps-info to find available app IDs.'),
     startDate: z
         .string()
-        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
-        .optional()
-        .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
+        .describe('Start date for the usage patterns query in YYYY-MM-DD format (e.g., 2025-01-01).')
+        .optional(),
     endDate: z
         .string()
-        .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
-        .optional()
-        .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
+        .describe('End date for the usage patterns query in YYYY-MM-DD format (e.g., 2025-12-31).')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });

package/mcp-server/tools/project/GetBuildLogsTool.d.ts

@@ -5,12 +5,12 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     buildId: z.ZodNumber;
-    logLevel: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+    logLevel: z.ZodOptional<z.ZodEnum<{
         ERROR: "ERROR";
         WARN: "WARN";
         INFO: "INFO";
         ALL: "ALL";
-    }>>>;
+    }>>;
 }, z.core.$strip>;
 export type GetBuildLogsInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class GetBuildLogsTool extends Tool<GetBuildLogsInputSchema> {

package/mcp-server/tools/project/GetBuildLogsTool.js

@@ -18,9 +18,8 @@ const inputSchema = {
         .describe('Build ID to fetch logs for. Use get-build-status to find recent build IDs.'),
     logLevel: z
         .enum(['ERROR', 'WARN', 'INFO', 'ALL'])
-        .optional()
-        .default('ALL')
-        .describe('Filter logs by level. ERROR: Show only errors, WARN: Show only warnings, INFO: Show only info, ALL: Show all logs.'),
+        .describe('Filter logs by level. ERROR: Show only errors, WARN: Show only warnings, INFO: Show only info, ALL: Show all logs. Defaults to ALL if not specified.')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });
@@ -85,14 +84,14 @@ export class GetBuildLogsTool extends Tool {
             if (allLogs.length === 0) {
                 return formatTextContents(absoluteCurrentWorkingDirectory, `No logs found for build #${buildId} in project '${projectName}'.`);
             }
-            const filteredLogs = filterLogsByLevel(allLogs, logLevel);
+            const resolvedLogLevel = logLevel || 'ALL';
+            const filteredLogs = filterLogsByLevel(allLogs, resolvedLogLevel);
             let output;
             if (filteredLogs.length === 0) {
-                // No logs match filter, show all logs instead
-                output = `No ${logLevel} level logs found for build #${buildId} in '${projectName}'.\nShowing all logs instead:\n\n${formatLogs(allLogs)}`;
+                output = `No ${resolvedLogLevel} level logs found for build #${buildId} in '${projectName}'.\nShowing all logs instead:\n\n${formatLogs(allLogs)}`;
             }
             else {
-                output = `Logs for build #${buildId} in '${projectName}' (${logLevel} level):\n\n${formatLogs(filteredLogs)}`;
+                output = `Logs for build #${buildId} in '${projectName}' (${resolvedLogLevel} level):\n\n${formatLogs(filteredLogs)}`;
             }
             return formatTextContents(absoluteCurrentWorkingDirectory, output);
         }

package/mcp-server/tools/project/GetBuildStatusTool.d.ts

@@ -5,7 +5,7 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     buildId: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type GetBuildStatusInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class GetBuildStatusTool extends Tool<GetBuildStatusInputSchema> {

package/mcp-server/tools/project/GetBuildStatusTool.js

@@ -19,9 +19,8 @@ const inputSchema = {
         .describe('Optional: Specific build ID to inspect. If omitted, shows recent builds to help identify the latest build.'),
     limit: z
         .number()
-        .optional()
-        .default(3)
-        .describe('Number of recent builds to fetch when buildId is not specified.'),
+        .describe('Number of recent builds to fetch when buildId is not specified. Defaults to 3 if not specified.')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });
@@ -127,7 +126,7 @@ export class GetBuildStatusTool extends Tool {
             }
             else {
                 const response = await fetchProjectBuilds(accountId, projectName, {
-                    limit,
+                    limit: limit || 3,
                 });
                 const { results } = response.data;
                 if (!results || results.length === 0) {

package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts

@@ -3,7 +3,12 @@ import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.
 import { z } from 'zod';
 declare const inputSchemaZodObject: z.ZodObject<{
     absoluteCurrentWorkingDirectory: z.ZodString;
-    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hs init">, z.ZodLiteral<"hs auth">, z.ZodLiteral<"hs project create">, z.ZodLiteral<"hs project upload">]>>;
+    command: z.ZodOptional<z.ZodEnum<{
+        "hs auth": "hs auth";
+        "hs project create": "hs project create";
+        "hs project upload": "hs project upload";
+        "hs init": "hs init";
+    }>>;
 }, z.core.$strip>;
 type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
 export declare class GuidedWalkthroughTool extends Tool<InputSchemaType> {

package/mcp-server/tools/project/GuidedWalkthroughTool.js

@@ -14,12 +14,7 @@ const nextCommands = {
 const inputSchema = {
     absoluteCurrentWorkingDirectory,
     command: z
-        .union([
-        z.literal('hs init'),
-        z.literal('hs auth'),
-        z.literal('hs project create'),
-        z.literal('hs project upload'),
-    ])
+        .enum(['hs init', 'hs auth', 'hs project create', 'hs project upload'])
         .describe('The command to learn more about.  Start with `hs init`')
         .optional(),
 };

package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js

@@ -1,5 +1,4 @@
 import { GetApiUsagePatternsByAppIdTool } from '../GetApiUsagePatternsByAppIdTool.js';
-import { z } from 'zod';
 import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { http } from '@hubspot/local-dev-lib/http';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
@@ -52,37 +51,6 @@ describe('mcp-server/tools/project/GetApiUsagePatternsByAppIdTool', () => {
             expect(result).toBe(mockRegisteredTool);
         });
     });
-    describe('input validation', () => {
-        const inputSchema = z.object({
-            appId: z
-                .string()
-                .describe('The application ID to get API usage patterns for.'),
-            startDate: z
-                .string()
-                .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
-                .optional()
-                .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
-            endDate: z
-                .string()
-                .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
-                .optional()
-                .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
-        });
-        it('should validate date format correctly', () => {
-            const validInput = {
-                appId: '12345',
-                startDate: '2025-01-01',
-                endDate: '2025-12-31',
-            };
-            const invalidInput = {
-                appId: '12345',
-                startDate: '2025-1-1',
-                endDate: '2025-12-31T00:00:00Z',
-            };
-            expect(() => inputSchema.parse(validInput)).not.toThrow();
-            expect(() => inputSchema.parse(invalidInput)).toThrow();
-        });
-    });
     describe('handler', () => {
         const input = {
             absoluteCurrentWorkingDirectory: '/test/dir',

package/mcp-server/tools/project/constants.d.ts

@@ -1,6 +1,17 @@
 import z from 'zod';
 export declare const absoluteProjectPath: z.ZodString;
 export declare const absoluteCurrentWorkingDirectory: z.ZodString;
-export declare const features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+export declare const features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    card: "card";
+    settings: "settings";
+    "app-event": "app-event";
+    page: "page";
+    "workflow-action-tool": "workflow-action-tool";
+    webhooks: "webhooks";
+    "workflow-action": "workflow-action";
+    "app-function": "app-function";
+    "app-object": "app-object";
+    scim: "scim";
+}>>>;
 export declare const docsSearchQuery: z.ZodString;
 export declare const docUrl: z.ZodString;

package/mcp-server/tools/project/constants.js

@@ -6,23 +6,19 @@ export const absoluteCurrentWorkingDirectory = z
     .string()
     .describe('The absolute path to the current working directory.');
 export const features = z
-    .array(z.union([
-    z.literal('card'),
-    z.literal('settings'),
-    z
-        .literal('app-function')
-        .describe('Also known as a public serverless function'),
-    z.literal('webhooks'),
-    z
-        .literal('workflow-action')
-        .describe('Also known as a custom workflow action.'),
-    z.literal('workflow-action-tool').describe('Also known as agent tools.'),
-    z.literal('app-object'),
-    z.literal('app-event'),
-    z.literal('scim'),
-    z.literal('page'),
+    .array(z.enum([
+    'card',
+    'settings',
+    'app-function',
+    'webhooks',
+    'workflow-action',
+    'workflow-action-tool',
+    'app-object',
+    'app-event',
+    'scim',
+    'page',
 ]))
-    .describe('The features to include in the project, multiple options can be selected')
+    .describe('The features to include in the project, multiple options can be selected. "app-function" is also known as a public serverless function. "workflow-action" is also known as a custom workflow action. "workflow-action-tool" is also known as agent tools.')
     .optional();
 export const docsSearchQuery = z
     .string()

package/package.json

@@ -1,13 +1,13 @@
 {
     "name": "@hubspot/cli",
-    "version": "8.0.4-experimental.1",
+    "version": "8.0.5-experimental.0",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",
     "type": "module",
     "dependencies": {
         "@hubspot/cms-dev-server": "1.2.16",
-        "@hubspot/local-dev-lib": "5.1.1",
+        "@hubspot/local-dev-lib": "0.7.2-experimental.0",
         "@hubspot/project-parsing-lib": "0.12.0",
         "@hubspot/serverless-dev-runtime": "7.0.7",
         "@hubspot/ui-extensions-dev-server": "1.1.8",
@@ -119,8 +119,6 @@
         "registry": "https://registry.npmjs.org/"
     },
     "resolutions": {
-        "eslint-visitor-keys": "4.2.0",
-        "react": "19.2.3",
-        "react-dom": "19.2.3"
+        "eslint-visitor-keys": "4.2.0"
     }
 }

package/ui/components/getStarted/GetStartedFlow.js

@@ -1,12 +1,15 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { sanitizeFileName, untildify } from '@hubspot/local-dev-lib/path';
 import { useApp, useFocus, useInput } from 'ink';
+import open from 'open';
 import { useCallback, useEffect, useReducer } from 'react';
 import { commands } from '../../../lang/en.js';
-import { createProjectAction, trackGetStartedUsage, uploadAndDeployAction, } from '../../../lib/getStartedV2Actions.js';
+import { createProjectAction, pollAppInstallation, trackGetStartedUsage, uploadAndDeployAction, } from '../../../lib/getStartedV2Actions.js';
+import { validateProjectDirectory } from '../../../lib/prompts/projectNameAndDestPrompt.js';
 import { uiAccountDescription } from '../../../lib/ui/index.js';
 import { ACTION_STATUSES, GET_STARTED_FLOW_STEPS, } from '../../lib/constants.js';
 import { flowReducer } from './reducer.js';
+import { InstallationScreen } from './screens/InstallationScreen.js';
 import { ProjectSetupScreen } from './screens/ProjectSetupScreen.js';
 import { UploadScreen } from './screens/UploadScreen.js';
 import { getProject } from './selectors.js';
@@ -44,6 +47,7 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
         statuses: {
             create: initialName ? ACTION_STATUSES.RUNNING : ACTION_STATUSES.IDLE,
             upload: ACTION_STATUSES.IDLE,
+            installApp: ACTION_STATUSES.IDLE,
         },
     });
     const [state, dispatch] = useReducer(flowReducer, getInitialState());
@@ -68,6 +72,16 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
         dispatch({ type: 'SET_STEP', payload: GET_STARTED_FLOW_STEPS.DEST_INPUT });
     }, []);
     const handleDestSubmit = useCallback(async () => {
+        const validationResult = validateProjectDirectory(project.destination);
+        if (validationResult !== true) {
+            dispatch({
+                type: 'SET_DEST_ERROR',
+                payload: typeof validationResult === 'string'
+                    ? validationResult
+                    : commands.getStarted.v2.unknownError,
+            });
+            return;
+        }
         dispatch({ type: 'SET_STEP', payload: GET_STARTED_FLOW_STEPS.CREATING });
         try {
             await createProjectAction({
@@ -108,6 +122,57 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
             dispatch({ type: 'UPLOAD_ERROR', payload: errorMessage });
         }
     }, [derivedAccountId, project.destination]);
+    const handlePollInstallation = useCallback(async () => {
+        const uploadApp = project.uploadResult?.app;
+        const projectId = project.uploadResult?.projectId;
+        if (!projectId || !uploadApp?.uid) {
+            dispatch({
+                type: 'INSTALL_APP_ERROR',
+                payload: commands.getStarted.v2.unknownError,
+            });
+            return;
+        }
+        try {
+            await pollAppInstallation({
+                accountId: derivedAccountId,
+                projectId,
+                appUid: uploadApp.uid,
+                requiredScopes: uploadApp.config?.auth?.requiredScopes,
+                optionalScopes: uploadApp.config?.auth?.optionalScopes,
+                onTimeout: () => {
+                    dispatch({ type: 'SET_POLLING_TIMED_OUT', payload: true });
+                },
+            });
+            dispatch({ type: 'INSTALL_APP_DONE' });
+        }
+        catch (error) {
+            dispatch({
+                type: 'INSTALL_APP_ERROR',
+                payload: error instanceof Error
+                    ? error.message
+                    : commands.getStarted.v2.unknownError,
+            });
+        }
+    }, [project.uploadResult, derivedAccountId]);
+    const handleBrowserOpen = useCallback(async (shouldOpen) => {
+        await trackGetStartedUsage({
+            step: 'open-install-page',
+            type: shouldOpen ? 'opened' : 'declined',
+        }, derivedAccountId);
+        if (shouldOpen && project.uploadResult?.installUrl) {
+            try {
+                await open(project.uploadResult.installUrl, { url: true });
+            }
+            catch (error) {
+                dispatch({
+                    type: 'SET_BROWSER_FAILED_URL',
+                    payload: project.uploadResult.installUrl,
+                });
+            }
+        }
+        dispatch({ type: 'START_INSTALL_APP' });
+        await handlePollInstallation();
+    }, [project.uploadResult, derivedAccountId, handlePollInstallation]);
     const handleNameChange = useCallback((value) => {
         dispatch({ type: 'SET_PROJECT_NAME', payload: value });
     }, []);
@@ -116,7 +181,8 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
     }, []);
     useInput((_, key) => {
         const hasError = state.statuses.create === ACTION_STATUSES.ERROR ||
-            state.statuses.upload === ACTION_STATUSES.ERROR;
+            state.statuses.upload === ACTION_STATUSES.ERROR ||
+            state.statuses.installApp === ACTION_STATUSES.ERROR;
         if (hasError) {
             exit();
             return;
@@ -126,11 +192,22 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
         if (state.step === GET_STARTED_FLOW_STEPS.COMPLETE) {
             handleUploadStart();
         }
+        else if (state.step === GET_STARTED_FLOW_STEPS.OPEN_APP_PROMPT) {
+            handleBrowserOpen(true);
+        }
+        else if (state.step === GET_STARTED_FLOW_STEPS.INSTALLING_APP &&
+            state.statuses.installApp === ACTION_STATUSES.DONE) {
+            // Ready for card setup - will be handled in PR3
+            exit();
+        }
     });
     if (state.step === GET_STARTED_FLOW_STEPS.UPLOADING ||
         state.step === GET_STARTED_FLOW_STEPS.OPEN_APP_PROMPT) {
         return _jsx(UploadScreen, { state: state, accountName: accountName });
     }
+    if (state.step === GET_STARTED_FLOW_STEPS.INSTALLING_APP) {
+        return _jsx(InstallationScreen, { state: state, accountName: accountName });
+    }
     // Show project setup screen for initial flow
     return (_jsx(ProjectSetupScreen, { state: state, onSelectOption: handleSelect, onNameChange: handleNameChange, onNameSubmit: handleNameSubmit, onDestChange: handleDestChange, onDestSubmit: handleDestSubmit }));
 }

package/ui/components/getStarted/reducer.d.ts

@@ -14,6 +14,7 @@ export type AppState = {
 export type ActionStatuses = {
     create: ActionStatus;
     upload: ActionStatus;
+    installApp: ActionStatus;
 };
 export type FlowState = {
     step: FlowStep;
@@ -21,6 +22,9 @@ export type FlowState = {
     app: AppState;
     statuses: ActionStatuses;
     error?: string;
+    destError?: string;
+    browserFailedUrl?: string;
+    pollingTimedOut?: boolean;
 };
 type FlowAction = {
     type: 'SET_STEP';
@@ -37,6 +41,9 @@ type FlowAction = {
 } | {
     type: 'SET_ERROR';
     payload: string;
+} | {
+    type: 'SET_DEST_ERROR';
+    payload: string;
 } | {
     type: 'CLEAR_ERROR';
 } | {
@@ -54,6 +61,19 @@ type FlowAction = {
 } | {
     type: 'UPLOAD_ERROR';
     payload: string;
+} | {
+    type: 'START_INSTALL_APP';
+} | {
+    type: 'INSTALL_APP_DONE';
+} | {
+    type: 'INSTALL_APP_ERROR';
+    payload: string;
+} | {
+    type: 'SET_BROWSER_FAILED_URL';
+    payload: string;
+} | {
+    type: 'SET_POLLING_TIMED_OUT';
+    payload: boolean;
 };
 export declare function flowReducer(state: FlowState, action: FlowAction): FlowState;
 export {};

package/ui/components/getStarted/reducer.js

@@ -17,6 +17,13 @@ export function flowReducer(state, action) {
             return {
                 ...state,
                 project: { ...state.project, destination: action.payload },
+                destError: undefined,
+            };
+        case 'SET_DEST_ERROR':
+            return {
+                ...state,
+                step: GET_STARTED_FLOW_STEPS.DEST_INPUT,
+                destError: action.payload,
             };
         case 'SET_ERROR':
             return { ...state, error: action.payload };
@@ -66,6 +73,35 @@ export function flowReducer(state, action) {
                 statuses: { ...state.statuses, upload: ACTION_STATUSES.ERROR },
                 error: action.payload,
             };
+        case 'START_INSTALL_APP':
+            return {
+                ...state,
+                step: GET_STARTED_FLOW_STEPS.INSTALLING_APP,
+                statuses: { ...state.statuses, installApp: ACTION_STATUSES.RUNNING },
+                error: undefined,
+                pollingTimedOut: false,
+            };
+        case 'INSTALL_APP_DONE':
+            return {
+                ...state,
+                statuses: { ...state.statuses, installApp: ACTION_STATUSES.DONE },
+            };
+        case 'INSTALL_APP_ERROR':
+            return {
+                ...state,
+                statuses: { ...state.statuses, installApp: ACTION_STATUSES.ERROR },
+                error: action.payload,
+            };
+        case 'SET_BROWSER_FAILED_URL':
+            return {
+                ...state,
+                browserFailedUrl: action.payload,
+            };
+        case 'SET_POLLING_TIMED_OUT':
+            return {
+                ...state,
+                pollingTimedOut: action.payload,
+            };
         default:
             return state;
     }

package/ui/components/getStarted/screens/InstallationScreen.d.ts

@@ -0,0 +1,7 @@
+import { FlowState } from '../reducer.js';
+type InstallationScreenProps = {
+    state: FlowState;
+    accountName: string;
+};
+export declare function InstallationScreen({ state, accountName, }: InstallationScreenProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/ui/components/getStarted/screens/InstallationScreen.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { commands } from '../../../../lang/en.js';
+import { ActionSection } from '../../ActionSection.js';
+import { BoxWithTitle } from '../../BoxWithTitle.js';
+import { INK_COLORS } from '../../../styles.js';
+import { getProject } from '../selectors.js';
+import { ACTION_STATUSES, GET_STARTED_FLOW_STEPS, } from '../../../lib/constants.js';
+export function InstallationScreen({ state, accountName, }) {
+    const project = getProject(state);
+    const titleText = commands.getStarted.v2.startTitle;
+    // If we get to the installation screen, the app is uploaded and we have the name
+    const appName = project.uploadResult?.app?.config.name;
+    return (_jsx(BoxWithTitle, { flexGrow: 1, title: "hs get-started", borderColor: INK_COLORS.HUBSPOT_ORANGE, titleBackgroundColor: INK_COLORS.HUBSPOT_ORANGE, children: _jsxs(Box, { flexDirection: "column", rowGap: 1, children: [_jsx(Text, { bold: true, children: titleText }), _jsx(Text, { children: commands.getStarted.v2.installInstructions }), _jsx(ActionSection, { status: state.statuses.installApp, statusText: commands.getStarted.v2.installingApp(appName, accountName) }), state.browserFailedUrl && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(Text, { color: INK_COLORS.WARNING_YELLOW, children: commands.getStarted.v2.browserFailedToOpen(state.browserFailedUrl) }) })), state.pollingTimedOut && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(Text, { color: INK_COLORS.WARNING_YELLOW, children: commands.getStarted.v2.pollingTimeout(2) }) })), state.step === GET_STARTED_FLOW_STEPS.INSTALLING_APP &&
+                    state.statuses.installApp === ACTION_STATUSES.DONE && (_jsx(Text, { children: commands.getStarted.v2.pressEnterToContinueSetup }))] }) }));
+}

package/ui/components/getStarted/screens/ProjectSetupScreen.js

@@ -35,5 +35,6 @@ export function ProjectSetupScreen({ state, onSelectOption, onNameChange, onName
     return (_jsx(BoxWithTitle, { flexGrow: 1, title: "hs get-started", borderColor: INK_COLORS.HUBSPOT_ORANGE, titleBackgroundColor: INK_COLORS.HUBSPOT_ORANGE, children: _jsxs(Box, { flexDirection: "column", rowGap: 1, children: [_jsx(Text, { bold: true, children: titleText }), state.step === GET_STARTED_FLOW_STEPS.SELECT ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: overviewText }), _jsx(Text, { children: projectsText }), _jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 1, children: [_jsx(Text, { color: INK_COLORS.HUBSPOT_TEAL, children: "?" }), _jsx(Text, { children: selectPrompt })] }), _jsx(SelectInput, { items: GET_STARTED_FLOW_OPTIONS, onSelect: onSelectOption })] })) : (_jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 1, children: [_jsx(Text, { color: INK_COLORS.HUBSPOT_TEAL, children: "?" }), _jsx(Text, { children: `${selectPrompt}` }), _jsx(Text, { color: INK_COLORS.INFO_BLUE, children: state.app.selectedLabel })] })), _jsxs(ActionSection, { status: state.statuses.create, statusText: runningProjectCreateText, errorMessage: state.statuses.create === ACTION_STATUSES.ERROR
                         ? `${state.error}\n\n${commands.getStarted.v2.pressKeyToExit}`
                         : undefined, children: [state.step !== GET_STARTED_FLOW_STEPS.SELECT && (_jsx(InputField, { flag: "name", prompt: "Enter your project name", value: project.name, isEditing: state.step === GET_STARTED_FLOW_STEPS.NAME_INPUT, onChange: onNameChange, onSubmit: onNameSubmit })), state.step !== GET_STARTED_FLOW_STEPS.SELECT &&
-                            state.step !== GET_STARTED_FLOW_STEPS.NAME_INPUT && (_jsx(InputField, { flag: "dest", prompt: "Choose where to create the project", value: project.destination, isEditing: state.step === GET_STARTED_FLOW_STEPS.DEST_INPUT, onChange: onDestChange, onSubmit: onDestSubmit }))] }), state.step === GET_STARTED_FLOW_STEPS.COMPLETE && (_jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 1, children: [_jsx(Text, { color: INK_COLORS.HUBSPOT_TEAL, children: "?" }), _jsx(Text, { children: commands.getStarted.v2.pressEnterToContinueDeploy(state.app.selectedLabel) })] }))] }) }));
+                            state.step !== GET_STARTED_FLOW_STEPS.NAME_INPUT && (_jsxs(_Fragment, { children: [_jsx(InputField, { flag: "dest", prompt: "Choose where to create the project", value: project.destination, isEditing: state.step === GET_STARTED_FLOW_STEPS.DEST_INPUT, onChange: onDestChange, onSubmit: onDestSubmit }), state.destError &&
+                                    state.step === GET_STARTED_FLOW_STEPS.DEST_INPUT && (_jsx(Text, { color: INK_COLORS.ALERT_RED, children: state.destError }))] }))] }), state.step === GET_STARTED_FLOW_STEPS.COMPLETE && (_jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 1, children: [_jsx(Text, { color: INK_COLORS.HUBSPOT_TEAL, children: "?" }), _jsx(Text, { children: commands.getStarted.v2.pressEnterToContinueDeploy(state.app.selectedLabel) })] }))] }) }));
 }

package/ui/lib/constants.d.ts

@@ -12,5 +12,6 @@ export declare const GET_STARTED_FLOW_STEPS: {
     readonly INSTALLING: "installing";
     readonly UPLOADING: "uploading";
     readonly OPEN_APP_PROMPT: "open-app-prompt";
+    readonly INSTALLING_APP: "installing-app";
     readonly COMPLETE: "complete";
 };

package/ui/lib/constants.js

@@ -12,5 +12,6 @@ export const GET_STARTED_FLOW_STEPS = {
     INSTALLING: 'installing',
     UPLOADING: 'uploading',
     OPEN_APP_PROMPT: 'open-app-prompt',
+    INSTALLING_APP: 'installing-app',
     COMPLETE: 'complete',
 };