@hubspot/cli 7.7.34-experimental.0 → 7.8.0-beta.0

package/lib/ui/uiMessages.d.ts

@@ -0,0 +1,68 @@
+export declare const uiMessages: {
+    betaTag: string;
+    deprecatedTag: string;
+    deprecatedDescription: (message: string, command: string, url?: string) => string;
+    disabledMessage: (command: string, url?: string) => string;
+    disabledUrlText: string;
+    featureHighlight: {
+        defaultTitle: string;
+        featureKeys: {
+            accountOption: {
+                command: string;
+                message: (command: string) => string;
+            };
+            accountsListCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            accountsUseCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            authCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            feedbackCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            helpCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            projectCreateCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            projectDeployCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            projectHelpCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            projectUploadCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            projectDevCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            projectInstallDepsCommand: {
+                command: string;
+                message: (command: string) => string;
+            };
+            projectCommandTip: {
+                message: string;
+            };
+            sampleProjects: {
+                linkText: string;
+                url: string;
+                message: (link: string) => string;
+            };
+        };
+    };
+};

package/lib/ui/uiMessages.js

@@ -0,0 +1,71 @@
+// UI messages for the UI module - separate file to avoid circular imports with lang/en.ts
+// This contains the same strings that would be in lib.ui.* from lang/en.ts
+import { uiCommandReference, uiLink } from './index.js';
+export const uiMessages = {
+    betaTag: '[BETA]',
+    deprecatedTag: '[DEPRECATED]',
+    deprecatedDescription: (message, command, url) => `${message}. The ${uiCommandReference(command)} command is deprecated and will be disabled soon. ${url ? uiLink('Learn more', url) : ''}`,
+    disabledMessage: (command, url) => `The ${uiCommandReference(command)} command is disabled. Run ${uiCommandReference('npm i -g @hubspot/cli@latest')} to update to the latest HubSpot CLI version. ${url ? uiLink('Learn more', url) : ''}`,
+    disabledUrlText: 'See all HubSpot CLI commands here.',
+    featureHighlight: {
+        defaultTitle: "What's next?",
+        featureKeys: {
+            accountOption: {
+                command: '--account',
+                message: (command) => `Use the ${command} option with any command to override the default account`,
+            },
+            accountsListCommand: {
+                command: 'hs accounts list',
+                message: (command) => `${command} - See a list of configured HubSpot accounts`,
+            },
+            accountsUseCommand: {
+                command: 'hs accounts use',
+                message: (command) => `${command} - Set the Hubspot account that the CLI will target by default`,
+            },
+            authCommand: {
+                command: 'hs auth',
+                message: (command) => `${command} - Connect the CLI to additional HubSpot accounts`,
+            },
+            feedbackCommand: {
+                command: 'hs feedback',
+                message: (command) => `${command} - Report a bug or leave feedback`,
+            },
+            helpCommand: {
+                command: 'hs help',
+                message: (command) => `${command} - See a list of available commands`,
+            },
+            projectCreateCommand: {
+                command: 'hs project create',
+                message: (command) => `${command} - Create a new project`,
+            },
+            projectDeployCommand: {
+                command: 'hs project deploy',
+                message: (command) => `Ready to take your project live? Run ${command}`,
+            },
+            projectHelpCommand: {
+                command: 'hs project --help',
+                message: (command) => `${command} - Learn more about available project commands`,
+            },
+            projectUploadCommand: {
+                command: 'hs project upload',
+                message: (command) => `${command} - Upload your project to HubSpot and trigger builds`,
+            },
+            projectDevCommand: {
+                command: 'hs project dev',
+                message: (command) => `${command} - Set up a test environment and start local development`,
+            },
+            projectInstallDepsCommand: {
+                command: 'hs project install-deps',
+                message: (command) => `${command} - Install all project dependencies`,
+            },
+            projectCommandTip: {
+                message: 'Tip: All project commands must be run from within a project directory',
+            },
+            sampleProjects: {
+                linkText: "HubSpot's sample projects",
+                url: 'https://developers.hubspot.com/docs/platform/sample-projects?utm_source=cli&utm_content=project_create_whats_next',
+                message: (link) => `See ${link}`,
+            },
+        },
+    },
+};

package/lib/usageTracking.js

@@ -1,7 +1,7 @@
 import { trackUsage } from '@hubspot/local-dev-lib/trackUsage';
 import { isTrackingAllowed, getAccountConfig, } from '@hubspot/local-dev-lib/config';
 import { API_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constants/auth';
-import { logger } from '@hubspot/local-dev-lib/logger';
+import { uiLogger } from './ui/logger.js';
 import packageJson from '../package.json' with { type: 'json' };
 const version = packageJson.version;
 import { debugError } from './errorHandlers/index.js';
@@ -31,7 +31,7 @@ export async function trackCommandUsage(command, meta = {}, accountId) {
     if (!isTrackingAllowed()) {
         return;
     }
-    logger.debug('Attempting to track usage of "%s" command', command);
+    uiLogger.debug(`Attempting to track usage of "${command}" command`);
     let authType = 'unknown';
     if (accountId) {
         const accountConfig = getAccountConfig(accountId);
@@ -44,7 +44,7 @@ export async function trackCommandUsage(command, meta = {}, accountId) {
         action: 'cli-command',
         command,
         authType,
-        ...meta,
+        meta,
         accountId,
     });
 }
@@ -53,10 +53,10 @@ export async function trackHelpUsage(command) {
         return;
     }
     if (command) {
-        logger.debug('Tracking help usage of "%s" sub-command', command);
+        uiLogger.debug(`Tracking help usage of "${command}" sub-command`);
     }
     else {
-        logger.debug('Tracking help usage of main command');
+        uiLogger.debug('Tracking help usage of main command');
     }
     return trackCliInteraction({
         action: 'cli-help',
@@ -84,7 +84,7 @@ export async function trackCommandMetadataUsage(command, meta = {}, accountId) {
     if (!isTrackingAllowed()) {
         return;
     }
-    logger.debug('Attempting to track metadata usage of "%s" command', command);
+    uiLogger.debug(`Attempting to track metadata usage of "${command}" command`);
     let authType = 'unknown';
     if (accountId) {
         const accountConfig = getAccountConfig(accountId);
@@ -122,7 +122,7 @@ async function trackCliInteraction({ action, accountId, command, authType, meta
                     action: 'cli-mcp-server',
                     type: process.env.HUBSPOT_MCP_AI_AGENT,
                 }, accountId);
-                logger.debug('Sent AI usage tracking command event: %o', {
+                uiLogger.debug('Sent AI usage tracking command event:', {
                     ...usageTrackingEvent,
                     action: 'cli-mcp-server',
                     type: process.env.HUBSPOT_MCP_AI_AGENT,
@@ -133,12 +133,12 @@ async function trackCliInteraction({ action, accountId, command, authType, meta
             }
         }
         try {
+            uiLogger.debug('Sent usage tracking command event:', usageTrackingEvent);
             return trackUsage('cli-interaction', EventClass.INTERACTION, usageTrackingEvent, accountId);
         }
         catch (error) {
             debugError(error);
         }
-        logger.debug('Sent usage tracking command event: %o', usageTrackingEvent);
     }
     catch (e) {
         debugError(e);

package/lib/validation.js

@@ -1,6 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import { logger } from '@hubspot/local-dev-lib/logger';
+import { uiLogger } from '../lib/ui/logger.js';
 import { CMS_PUBLISH_MODE } from '@hubspot/local-dev-lib/constants/files';
 import { API_KEY_AUTH_METHOD, OAUTH_AUTH_METHOD, PERSONAL_ACCESS_KEY_AUTH_METHOD, } from '@hubspot/local-dev-lib/constants/auth';
 import { commaSeparatedValues } from '@hubspot/local-dev-lib/text';
@@ -10,43 +10,43 @@ import { accessTokenForPersonalAccessKey } from '@hubspot/local-dev-lib/personal
 import { getAbsoluteFilePath, getCwd, getExt, } from '@hubspot/local-dev-lib/path';
 import { getCmsPublishMode } from './commonOpts.js';
 import { logError } from './errorHandlers/index.js';
+import { lib } from '../lang/en.js';
 export async function validateAccount(options) {
     const { derivedAccountId, userProvidedAccount } = options;
     const accountId = getAccountId(derivedAccountId);
     if (!accountId) {
         if (userProvidedAccount) {
-            logger.error(`The account "${userProvidedAccount}" could not be found in the config`);
+            uiLogger.error(lib.validation.accountNotFoundInConfig(userProvidedAccount));
         }
         else {
-            logger.error('An account needs to be supplied either via "--account" or through setting a "defaultPortal"');
+            uiLogger.error(lib.validation.accountRequired);
         }
         return false;
     }
     if (userProvidedAccount && loadConfigFromEnvironment()) {
-        throw new Error('Cannot specify an account when environment variables are supplied. Please unset the environment variables or do not use the "--account" flag.');
+        throw new Error(lib.validation.userProvidedAccount);
     }
     const accountConfig = getAccountConfig(accountId);
     if (!accountConfig) {
-        logger.error(`The account ${accountId} has not been configured`);
+        uiLogger.error(lib.validation.accountNotConfigured(accountId));
         return false;
     }
     const { authType, auth, apiKey, personalAccessKey } = accountConfig;
     if (typeof authType === 'string' && authType !== authType.toLowerCase()) {
-        logger.error(`Invalid "authType" value "${authType}" for account "${accountId}" in config file: ${getConfigPath()}. Valid values are ${commaSeparatedValues([
+        uiLogger.error(lib.validation.invalidAuthType(authType, accountId, getConfigPath() || '', commaSeparatedValues([
             PERSONAL_ACCESS_KEY_AUTH_METHOD,
             OAUTH_AUTH_METHOD,
             API_KEY_AUTH_METHOD,
-        ].map(method => method.value))}.`);
+        ].map(method => method.value))));
     }
     if (authType === 'oauth2') {
         if (typeof auth !== 'object') {
-            logger.error(`The OAuth2 auth configuration for account ${accountId} is missing`);
+            uiLogger.error(lib.validation.oauth2ConfigMissing(accountId));
             return false;
         }
         const { clientId, clientSecret, tokenInfo } = auth;
         if (!clientId || !clientSecret || !tokenInfo || !tokenInfo.refreshToken) {
-            logger.error(`The OAuth2 configuration for account ${accountId} is incorrect`);
-            logger.error('Run "hs auth --type=oauth2" to reauthenticate');
+            uiLogger.error(lib.validation.oauth2ConfigIncorrect(accountId));
             return false;
         }
         const oauth = getOauthManager(accountId, accountConfig);
@@ -56,7 +56,7 @@ export async function validateAccount(options) {
                 accessToken = await oauth.accessToken();
             }
             if (!accessToken) {
-                logger.error(`The OAuth2 access token could not be found for accountId ${accountId}`);
+                uiLogger.error(lib.validation.oauth2AccessTokenNotFound(accountId));
                 return false;
             }
         }
@@ -67,13 +67,13 @@ export async function validateAccount(options) {
     }
     else if (authType === 'personalaccesskey') {
         if (!personalAccessKey) {
-            logger.error(`The account "${accountId}" is configured to use a access key for authentication and is missing a "personalAccessKey" in the configuration file`);
+            uiLogger.error(lib.validation.personalAccessKeyMissing(accountId));
             return false;
         }
         try {
             const accessToken = await accessTokenForPersonalAccessKey(accountId);
             if (!accessToken) {
-                logger.error(`An OAuth2 access token for account "${accountId} could not be retrieved using the "personalAccessKey" provided`);
+                uiLogger.error(lib.validation.personalAccessKeyTokenRetrievalFailed(accountId));
                 return false;
             }
         }
@@ -83,7 +83,7 @@ export async function validateAccount(options) {
         }
     }
     else if (!apiKey) {
-        logger.error(`The accountId ${accountId} is missing authentication configuration`);
+        uiLogger.error(lib.validation.authConfigurationMissing(accountId));
         return false;
     }
     return true;
@@ -93,15 +93,12 @@ export function validateCmsPublishMode(options) {
     if (CMS_PUBLISH_MODE[cmsPublishMode]) {
         return true;
     }
-    const modesMessage = `Available CMS publish modes are: ${Object.values(CMS_PUBLISH_MODE).join(', ')}.`;
+    const modesMessage = lib.validation.availableCMSModes(Object.values(CMS_PUBLISH_MODE).join(', '));
     if (cmsPublishMode != null) {
-        logger.error([
-            `The CMS publish mode "${cmsPublishMode}" is invalid.`,
-            modesMessage,
-        ].join(' '));
+        uiLogger.error(lib.validation.invalidCmsPublishMode(cmsPublishMode, modesMessage));
     }
     else {
-        logger.error(['The CMS publish mode option is missing.', modesMessage].join(' '));
+        uiLogger.error(lib.validation.missingCmsPublishMode(modesMessage));
     }
     return false;
 }
@@ -124,11 +121,11 @@ export function fileExists(_path) {
 export function checkAndConvertToJson(_path) {
     const filePath = getAbsoluteFilePath(_path);
     if (!fileExists(filePath)) {
-        logger.error(`The path "${_path}" is not a path to a file`);
+        uiLogger.error(lib.validation.pathNotFile(_path));
         return null;
     }
     if (getExt(_path) !== 'json') {
-        logger.error(`The file "${_path}" must be a valid JSON file`);
+        uiLogger.error(lib.validation.fileNotJson(_path));
         return null;
     }
     let result;
@@ -136,7 +133,7 @@ export function checkAndConvertToJson(_path) {
         result = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
     }
     catch (e) {
-        logger.error(`The file "${_path}" contains invalid JSON`);
+        uiLogger.error(lib.validation.fileInvalidJson(_path));
         result = null;
     }
     return result;

package/lib/yargsUtils.d.ts

@@ -13,4 +13,4 @@ export declare function makeYargsBuilder<T>(callback: (yargs: Argv) => Argv<T>,
     };
     useJSONOutputOptions?: boolean;
 }): (yargs: Argv) => Promise<Argv<T>>;
-export declare function getExclusiveConflicts(options: string[]): Record<string, string[]>;
+export declare function strictEnforceBoolean(rawArgs: string[], booleanOptions: string[]): boolean;

package/lib/yargsUtils.js

@@ -1,5 +1,6 @@
 import { addCustomHelpOutput, addTestingOptions, addAccountOptions, addConfigOptions, addGlobalOptions, addUseEnvironmentOptions, addCmsPublishModeOptions, addJSONOutputOptions, } from './commonOpts.js';
 import { hasFlag } from './utils/hasFlag.js';
+import { commands } from '../lang/en.js';
 // Re-export for backwards compatibility
 export { hasFlag };
 export function makeYargsBuilder(callback, command, describe, options = {}) {
@@ -34,9 +35,15 @@ export function makeYargsBuilder(callback, command, describe, options = {}) {
         return result;
     };
 }
-export function getExclusiveConflicts(options) {
-    return options.reduce((acc, curr) => {
-        acc[curr] = options.filter(s => s !== curr);
-        return acc;
-    }, {});
+export function strictEnforceBoolean(rawArgs, booleanOptions) {
+    for (const option of booleanOptions) {
+        const argIndex = rawArgs.findIndex(arg => arg.startsWith(`--${option}=`));
+        if (argIndex !== -1) {
+            const value = rawArgs[argIndex].split('=')[1];
+            if (value && !['true', 'false'].includes(value.toLowerCase())) {
+                throw new Error(commands.config.subcommands.set.errors.invalidBoolean(option, value));
+            }
+        }
+    }
+    return true;
 }

package/mcp-server/tools/cms/HsCreateModuleTool.d.ts

@@ -13,19 +13,19 @@ declare const inputSchemaZodObject: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     absoluteCurrentWorkingDirectory: string;
     dest?: string | undefined;
-    global?: boolean | undefined;
     moduleLabel?: string | undefined;
     reactType?: boolean | undefined;
     contentTypes?: string | undefined;
+    global?: boolean | undefined;
     availableForNewContent?: boolean | undefined;
     userSuppliedName?: string | undefined;
 }, {
     absoluteCurrentWorkingDirectory: string;
     dest?: string | undefined;
-    global?: boolean | undefined;
     moduleLabel?: string | undefined;
     reactType?: boolean | undefined;
     contentTypes?: string | undefined;
+    global?: boolean | undefined;
     availableForNewContent?: boolean | undefined;
     userSuppliedName?: string | undefined;
 }>;

package/mcp-server/tools/index.js

@@ -7,6 +7,8 @@ import { ValidateProjectTool } from './project/ValidateProjectTool.js';
 import { GetConfigValuesTool } from './project/GetConfigValuesTool.js';
 import { DocsSearchTool } from './project/DocsSearchTool.js';
 import { DocFetchTool } from './project/DocFetchTool.js';
+import { GetApiUsagePatternsByAppIdTool } from './project/GetApiUsagePatternsByAppIdTool.js';
+import { GetApplicationInfoTool } from './project/GetApplicationInfoTool.js';
 import { HsListTool } from './cms/HsListTool.js';
 import { HsCreateModuleTool } from './cms/HsCreateModuleTool.js';
 import { HsCreateTemplateTool } from './cms/HsCreateTemplateTool.js';
@@ -24,6 +26,8 @@ export function registerProjectTools(mcpServer) {
         new GetConfigValuesTool(mcpServer).register(),
         new DocsSearchTool(mcpServer).register(),
         new DocFetchTool(mcpServer).register(),
+        new GetApiUsagePatternsByAppIdTool(mcpServer).register(),
+        new GetApplicationInfoTool(mcpServer).register(),
     ];
 }
 export function registerCmsTools(mcpServer) {

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

@@ -12,13 +12,13 @@ declare const inputSchemaZodObject: z.ZodObject<{
     addApp: boolean;
     auth?: "oauth" | "static" | undefined;
     distribution?: "marketplace" | "private" | undefined;
-    features?: ("card" | "page" | "settings" | "app-event" | "workflow-action-tool" | "workflow-action" | "app-function" | "webhooks" | "app-object" | "scim")[] | undefined;
+    features?: ("card" | "settings" | "page" | "app-event" | "workflow-action-tool" | "workflow-action" | "app-function" | "webhooks" | "app-object" | "scim")[] | undefined;
 }, {
     absoluteProjectPath: string;
     addApp: boolean;
     auth?: "oauth" | "static" | undefined;
     distribution?: "marketplace" | "private" | undefined;
-    features?: ("card" | "page" | "settings" | "app-event" | "workflow-action-tool" | "workflow-action" | "app-function" | "webhooks" | "app-object" | "scim")[] | undefined;
+    features?: ("card" | "settings" | "page" | "app-event" | "workflow-action-tool" | "workflow-action" | "app-function" | "webhooks" | "app-object" | "scim")[] | undefined;
 }>;
 export type AddFeatureInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class AddFeatureToProjectTool extends Tool<AddFeatureInputSchema> {

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

@@ -16,7 +16,7 @@ declare const inputSchemaZodObject: z.ZodObject<{
     name?: string | undefined;
     auth?: "oauth" | "static" | undefined;
     distribution?: "marketplace" | "private" | undefined;
-    features?: ("card" | "page" | "settings" | "app-event" | "workflow-action-tool" | "workflow-action" | "app-function" | "webhooks" | "app-object" | "scim")[] | undefined;
+    features?: ("card" | "settings" | "page" | "app-event" | "workflow-action-tool" | "workflow-action" | "app-function" | "webhooks" | "app-object" | "scim")[] | undefined;
 }, {
     projectBase: "app" | "empty";
     absoluteCurrentWorkingDirectory: string;
@@ -24,7 +24,7 @@ declare const inputSchemaZodObject: z.ZodObject<{
     name?: string | undefined;
     auth?: "oauth" | "static" | undefined;
     distribution?: "marketplace" | "private" | undefined;
-    features?: ("card" | "page" | "settings" | "app-event" | "workflow-action-tool" | "workflow-action" | "app-function" | "webhooks" | "app-object" | "scim")[] | undefined;
+    features?: ("card" | "settings" | "page" | "app-event" | "workflow-action-tool" | "workflow-action" | "app-function" | "webhooks" | "app-object" | "scim")[] | undefined;
 }>;
 export type CreateProjectInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class CreateProjectTool extends Tool<CreateProjectInputSchema> {

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

@@ -2,10 +2,13 @@ import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.
 import z from 'zod';
 import { TextContentResponse, Tool } from '../../types.js';
 declare const inputSchemaZodObject: z.ZodObject<{
+    absoluteCurrentWorkingDirectory: z.ZodString;
     docsSearchQuery: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    absoluteCurrentWorkingDirectory: string;
     docsSearchQuery: string;
 }, {
+    absoluteCurrentWorkingDirectory: string;
     docsSearchQuery: string;
 }>;
 export interface DocsSearchResponse {
@@ -20,7 +23,7 @@ export interface DocsSearchResponse {
 type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
 export declare class DocsSearchTool extends Tool<InputSchemaType> {
     constructor(mcpServer: McpServer);
-    handler({ docsSearchQuery, }: InputSchemaType): Promise<TextContentResponse>;
+    handler({ absoluteCurrentWorkingDirectory, docsSearchQuery, }: InputSchemaType): Promise<TextContentResponse>;
     register(): RegisteredTool;
 }
 export {};

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

@@ -3,10 +3,11 @@ import z from 'zod';
 import { Tool } from '../../types.js';
 import { formatTextContents } from '../../utils/content.js';
 import { trackToolUsage } from '../../utils/toolUsageTracking.js';
-import { docsSearchQuery } from './constants.js';
-import { getAccountId, getConfigPath, loadConfig, } from '@hubspot/local-dev-lib/config';
+import { absoluteCurrentWorkingDirectory, docsSearchQuery, } from './constants.js';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { getAccountIdFromCliConfig } from '../../utils/cliConfig.js';
 const inputSchema = {
+    absoluteCurrentWorkingDirectory,
     docsSearchQuery,
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -18,10 +19,9 @@ export class DocsSearchTool extends Tool {
     constructor(mcpServer) {
         super(mcpServer);
     }
-    async handler({ docsSearchQuery, }) {
+    async handler({ absoluteCurrentWorkingDirectory, docsSearchQuery, }) {
         await trackToolUsage(toolName, { mode: docsSearchQuery });
-        loadConfig(getConfigPath());
-        const accountId = getAccountId();
+        const accountId = getAccountIdFromCliConfig(absoluteCurrentWorkingDirectory);
         if (!accountId) {
             const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
             return formatTextContents(authErrorMessage);

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

@@ -0,0 +1,23 @@
+import { TextContentResponse, Tool } from '../../types.js';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+declare const inputSchemaZodObject: z.ZodObject<{
+    appId: z.ZodString;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    appId: string;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}, {
+    appId: string;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}>;
+export type GetApiUsagePatternsByAppIdInputSchema = z.infer<typeof inputSchemaZodObject>;
+export declare class GetApiUsagePatternsByAppIdTool extends Tool<GetApiUsagePatternsByAppIdInputSchema> {
+    constructor(mcpServer: McpServer);
+    handler({ appId, startDate, endDate, }: GetApiUsagePatternsByAppIdInputSchema): Promise<TextContentResponse>;
+    register(): RegisteredTool;
+}
+export {};

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

@@ -0,0 +1,68 @@
+import { Tool } from '../../types.js';
+import { z } from 'zod';
+import { trackToolUsage } from '../../utils/toolUsageTracking.js';
+import { http } from '@hubspot/local-dev-lib/http';
+import { formatTextContents } from '../../utils/content.js';
+import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { getAccountId } from '@hubspot/local-dev-lib/config';
+const inputSchema = {
+    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-applications-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).'),
+    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).'),
+};
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const inputSchemaZodObject = z.object({ ...inputSchema });
+const toolName = 'get-api-usage-patterns-by-app-id';
+export class GetApiUsagePatternsByAppIdTool extends Tool {
+    constructor(mcpServer) {
+        super(mcpServer);
+    }
+    async handler({ appId, startDate, endDate, }) {
+        await trackToolUsage(toolName);
+        try {
+            // Get account ID from CLI config
+            const accountId = getAccountId();
+            if (!accountId) {
+                const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
+                return formatTextContents(authErrorMessage);
+            }
+            const response = await http.get(accountId, {
+                url: `app/feature/utilization/public/v3/insights/app/${appId}/usage-patterns`,
+                params: {
+                    ...(startDate && { startDate }),
+                    ...(endDate && { endDate }),
+                },
+            });
+            // Format the response for display
+            const { data } = response;
+            const formattedResult = JSON.stringify(data, null, 2);
+            return formatTextContents(formattedResult);
+        }
+        catch (error) {
+            if (isHubSpotHttpError(error)) {
+                // Handle HubSpot-specific HTTP errors
+                return formatTextContents(error.toString());
+            }
+            const errorMessage = `${error instanceof Error ? error.message : String(error)}`;
+            return formatTextContents(errorMessage);
+        }
+    }
+    register() {
+        return this.mcpServer.registerTool(toolName, {
+            title: 'Get API Usage Patterns by App ID',
+            description: 'Retrieves detailed API usage pattern analytics for a specific HubSpot application. Requires an appId (string) to identify the target application. Optionally accepts startDate and endDate parameters in YYYY-MM-DD format to filter results within a specific time range. Returns patternSummaries object containing usage statistics including portalPercentage (percentage of portals using this pattern) and numOfPortals (total count of portals) for different usage patterns. This data helps analyze how the application is being used across different HubSpot portals and can inform optimization decisions.',
+            inputSchema,
+        }, this.handler);
+    }
+}

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

@@ -0,0 +1,11 @@
+import { TextContentResponse, Tool } from '../../types.js';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+declare const inputSchemaZodObject: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetApplicationInfoInputSchema = z.infer<typeof inputSchemaZodObject>;
+export declare class GetApplicationInfoTool extends Tool<GetApplicationInfoInputSchema> {
+    constructor(mcpServer: McpServer);
+    handler({}: GetApplicationInfoInputSchema): Promise<TextContentResponse>;
+    register(): RegisteredTool;
+}
+export {};