@hubspot/cli 7.7.32-experimental.0 → 7.7.33-experimental.0

package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js

@@ -0,0 +1,183 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { HsFunctionLogsTool } from '../HsFunctionLogsTool.js';
+import { runCommandInDir } from '../../../utils/project.js';
+import { addFlag } from '../../../utils/command.js';
+vi.mock('@modelcontextprotocol/sdk/server/mcp.js');
+vi.mock('../../../utils/project');
+vi.mock('../../../utils/command');
+vi.mock('../../../utils/toolUsageTracking', () => ({
+    trackToolUsage: vi.fn(),
+}));
+const mockRunCommandInDir = runCommandInDir;
+const mockAddFlag = addFlag;
+describe('HsFunctionLogsTool', () => {
+    let mockMcpServer;
+    let tool;
+    let mockRegisteredTool;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // @ts-expect-error Not mocking the whole server
+        mockMcpServer = {
+            registerTool: vi.fn(),
+        };
+        mockRegisteredTool = {};
+        mockMcpServer.registerTool.mockReturnValue(mockRegisteredTool);
+        tool = new HsFunctionLogsTool(mockMcpServer);
+    });
+    describe('register', () => {
+        it('should register the tool with the MCP server', () => {
+            const result = tool.register();
+            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('get-hubspot-cms-serverless-function-logs', expect.objectContaining({
+                title: 'Get HubSpot CMS serverless function logs for an endpoint',
+                description: 'Retrieve logs for HubSpot CMS serverless functions. Use this tool to help debug issues with serverless functions by reading the production logs. Supports various options like latest, compact, and limiting results. Use after listing functions with list-hubspot-cms-serverless-functions to get the endpoint path.',
+                inputSchema: expect.any(Object),
+            }), expect.any(Function));
+            expect(result).toBe(mockRegisteredTool);
+        });
+    });
+    describe('handler', () => {
+        it('should execute basic hs logs command with endpoint', async () => {
+            mockRunCommandInDir.mockResolvedValue({
+                stdout: '2023-01-01 10:00:00 INFO Function executed successfully',
+                stderr: '',
+            });
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: 'my-function',
+            });
+            expect(mockRunCommandInDir).toHaveBeenCalledWith('/test/dir', 'hs logs my-function');
+            expect(result.content).toHaveLength(2);
+            expect(result.content[0].text).toContain('Function executed successfully');
+            expect(result.content[1].text).toBe('');
+        });
+        it('should strip leading slash from endpoint', async () => {
+            mockRunCommandInDir.mockResolvedValue({
+                stdout: '2023-01-01 10:00:00 INFO Function executed successfully',
+                stderr: '',
+            });
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: '/api/my-endpoint',
+            });
+            expect(mockRunCommandInDir).toHaveBeenCalledWith('/test/dir', 'hs logs api/my-endpoint');
+            expect(result.content).toHaveLength(2);
+            expect(result.content[0].text).toContain('Function executed successfully');
+            expect(result.content[1].text).toBe('');
+        });
+        it('should execute hs logs command with latest flag', async () => {
+            mockAddFlag.mockReturnValue('hs logs my-endpoint --latest');
+            mockRunCommandInDir.mockResolvedValue({
+                stdout: '2023-01-01 10:00:00 INFO Latest log entry',
+                stderr: '',
+            });
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: 'my-endpoint',
+                latest: true,
+            });
+            expect(mockAddFlag).toHaveBeenCalledWith('hs logs my-endpoint', 'latest', true);
+            expect(mockRunCommandInDir).toHaveBeenCalledWith('/test/dir', 'hs logs my-endpoint --latest');
+            expect(result.content).toHaveLength(2);
+            expect(result.content[0].text).toContain('Latest log entry');
+            expect(result.content[1].text).toBe('');
+        });
+        it('should execute hs logs command with compact flag', async () => {
+            mockAddFlag.mockReturnValue('hs logs my-endpoint --compact');
+            mockRunCommandInDir.mockResolvedValue({
+                stdout: 'compact log output',
+                stderr: '',
+            });
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: 'my-endpoint',
+                compact: true,
+            });
+            expect(mockAddFlag).toHaveBeenCalledWith('hs logs my-endpoint', 'compact', true);
+            expect(mockRunCommandInDir).toHaveBeenCalledWith('/test/dir', 'hs logs my-endpoint --compact');
+            expect(result.content).toHaveLength(2);
+            expect(result.content[0].text).toContain('compact log output');
+            expect(result.content[1].text).toBe('');
+        });
+        it('should execute hs logs command with limit parameter', async () => {
+            mockAddFlag.mockReturnValue('hs logs my-endpoint --limit 10');
+            mockRunCommandInDir.mockResolvedValue({
+                stdout: 'limited log entries',
+                stderr: '',
+            });
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: 'my-endpoint',
+                limit: 10,
+            });
+            expect(mockAddFlag).toHaveBeenCalledWith('hs logs my-endpoint', 'limit', 10);
+            expect(mockRunCommandInDir).toHaveBeenCalledWith('/test/dir', 'hs logs my-endpoint --limit 10');
+            expect(result.content).toHaveLength(2);
+            expect(result.content[0].text).toContain('limited log entries');
+            expect(result.content[1].text).toBe('');
+        });
+        it('should execute hs logs command with account parameter', async () => {
+            mockAddFlag.mockReturnValue('hs logs my-endpoint --account test-account');
+            mockRunCommandInDir.mockResolvedValue({
+                stdout: 'account-specific logs',
+                stderr: '',
+            });
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: 'my-endpoint',
+                account: 'test-account',
+            });
+            expect(mockAddFlag).toHaveBeenCalledWith('hs logs my-endpoint', 'account', 'test-account');
+            expect(mockRunCommandInDir).toHaveBeenCalledWith('/test/dir', 'hs logs my-endpoint --account test-account');
+            expect(result.content).toHaveLength(2);
+            expect(result.content[0].text).toContain('account-specific logs');
+            expect(result.content[1].text).toBe('');
+        });
+        it('should execute hs logs command with multiple parameters', async () => {
+            mockAddFlag
+                .mockReturnValueOnce('hs logs my-endpoint --latest')
+                .mockReturnValueOnce('hs logs my-endpoint --latest --compact')
+                .mockReturnValueOnce('hs logs my-endpoint --latest --compact --account test-account');
+            mockRunCommandInDir.mockResolvedValue({
+                stdout: 'latest compact logs',
+                stderr: '',
+            });
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: 'my-endpoint',
+                latest: true,
+                compact: true,
+                account: 'test-account',
+            });
+            expect(mockAddFlag).toHaveBeenCalledTimes(3);
+            expect(mockAddFlag).toHaveBeenNthCalledWith(1, 'hs logs my-endpoint', 'latest', true);
+            expect(mockAddFlag).toHaveBeenNthCalledWith(2, 'hs logs my-endpoint --latest', 'compact', true);
+            expect(mockAddFlag).toHaveBeenNthCalledWith(3, 'hs logs my-endpoint --latest --compact', 'account', 'test-account');
+            expect(mockRunCommandInDir).toHaveBeenCalledWith('/test/dir', 'hs logs my-endpoint --latest --compact --account test-account');
+            expect(result.content).toHaveLength(2);
+            expect(result.content[0].text).toContain('latest compact logs');
+            expect(result.content[1].text).toBe('');
+        });
+        it('should handle command execution errors', async () => {
+            mockRunCommandInDir.mockRejectedValue(new Error('Function not found'));
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: 'non-existent-function',
+            });
+            expect(result.content).toHaveLength(1);
+            expect(result.content[0].text).toContain('Error executing hs logs command: Function not found');
+        });
+        it('should handle stderr output', async () => {
+            mockRunCommandInDir.mockResolvedValue({
+                stdout: 'function logs',
+                stderr: 'Warning: Function may be slow to respond',
+            });
+            const result = await tool.handler({
+                absoluteCurrentWorkingDirectory: '/test/dir',
+                endpoint: 'slow-function',
+            });
+            expect(result.content).toHaveLength(2);
+            expect(result.content[0].text).toContain('function logs');
+            expect(result.content[1].text).toContain('Warning: Function may be slow to respond');
+        });
+    });
+});

package/mcp-server/tools/index.js

@@ -12,6 +12,7 @@ import { HsCreateModuleTool } from './cms/HsCreateModuleTool.js';
 import { HsCreateTemplateTool } from './cms/HsCreateTemplateTool.js';
 import { HsCreateFunctionTool } from './cms/HsCreateFunctionTool.js';
 import { HsListFunctionsTool } from './cms/HsListFunctionsTool.js';
+import { HsFunctionLogsTool } from './cms/HsFunctionLogsTool.js';
 export function registerProjectTools(mcpServer) {
     return [
         new UploadProjectTools(mcpServer).register(),
@@ -32,5 +33,6 @@ export function registerCmsTools(mcpServer) {
         new HsCreateTemplateTool(mcpServer).register(),
         new HsCreateFunctionTool(mcpServer).register(),
         new HsListFunctionsTool(mcpServer).register(),
+        new HsFunctionLogsTool(mcpServer).register(),
     ];
 }

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

@@ -6,19 +6,19 @@ declare const inputSchemaZodObject: z.ZodObject<{
     addApp: z.ZodBoolean;
     distribution: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"marketplace">, z.ZodLiteral<"private">]>>;
     auth: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"static">, z.ZodLiteral<"oauth">]>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">]>, "many">>;
+    features: z.ZodOptional<z.ZodArray<z.ZodUnion<[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<"scim">]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     absoluteProjectPath: string;
     addApp: boolean;
     auth?: "oauth" | "static" | undefined;
     distribution?: "marketplace" | "private" | undefined;
-    features?: ("card" | "settings" | "app-function" | "webhooks" | "workflow-action")[] | undefined;
+    features?: ("card" | "settings" | "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" | "settings" | "app-function" | "webhooks" | "workflow-action")[] | undefined;
+    features?: ("card" | "settings" | "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

@@ -8,7 +8,7 @@ declare const inputSchemaZodObject: z.ZodObject<{
     projectBase: z.ZodUnion<[z.ZodLiteral<"empty">, z.ZodLiteral<"app">]>;
     distribution: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"marketplace">, z.ZodLiteral<"private">]>>;
     auth: z.ZodOptional<z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"static">, z.ZodLiteral<"oauth">]>>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">]>, "many">>;
+    features: z.ZodOptional<z.ZodArray<z.ZodUnion<[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<"scim">]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     projectBase: "app" | "empty";
     absoluteCurrentWorkingDirectory: string;
@@ -16,7 +16,7 @@ declare const inputSchemaZodObject: z.ZodObject<{
     name?: string | undefined;
     auth?: "oauth" | "static" | undefined;
     distribution?: "marketplace" | "private" | undefined;
-    features?: ("card" | "settings" | "app-function" | "webhooks" | "workflow-action")[] | undefined;
+    features?: ("card" | "settings" | "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" | "settings" | "app-function" | "webhooks" | "workflow-action")[] | undefined;
+    features?: ("card" | "settings" | "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/GetConfigValuesTool.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 import { formatTextContents } from '../../utils/content.js';
 import { getIntermediateRepresentationSchema, mapToInternalType, } from '@hubspot/project-parsing-lib';
 import { getAccountId, getConfigPath, loadConfig, } from '@hubspot/local-dev-lib/config';
-import { useV3Api } from '../../../lib/projects/buildAndDeploy.js';
+import { useV3Api } from '../../../lib/projects/platformVersion.js';
 const inputSchema = {
     platformVersion: z
         .string()
@@ -43,8 +43,8 @@ export class GetConfigValuesTool extends Tool {
     register() {
         return this.mcpServer.registerTool(toolName, {
             title: 'Fetch the JSON Schema for component',
-            description: `Fetches and returns the JSON schema for the provided feature 'type' found in -hsmeta.json file. 
-        This should be called before editing a '-hsmeta.json' file to get the list of possible values and restrictions on those values.    
+            description: `Fetches and returns the JSON schema for the provided feature 'type' found in -hsmeta.json file.
+        This should be called before editing a '-hsmeta.json' file to get the list of possible values and restrictions on those values.
         This will only work for projects with platformVersion 2025.2 and beyond`,
             inputSchema,
         }, this.handler);

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

@@ -1,6 +1,6 @@
 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<[z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">]>, "many">>;
+export declare const features: z.ZodOptional<z.ZodArray<z.ZodUnion<[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<"scim">]>, "many">>;
 export declare const docsSearchQuery: z.ZodString;
 export declare const docUrl: z.ZodString;

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

@@ -6,15 +6,17 @@ export const absoluteCurrentWorkingDirectory = z
     .string()
     .describe('The absolute path to the current working directory.');
 export const features = z
-    .array(z
-    .union([
+    .array(z.union([
     z.literal('card'),
     z.literal('settings'),
     z.literal('app-function'),
     z.literal('webhooks'),
     z.literal('workflow-action'),
-])
-    .describe('The features to include in the project, multiple options can be selected'))
+    z.literal('workflow-action-tool'),
+    z.literal('app-object'),
+    z.literal('scim'),
+]))
+    .describe('The features to include in the project, multiple options can be selected')
     .optional();
 export const docsSearchQuery = z
     .string()

package/package.json

@@ -1,13 +1,13 @@
 {
     "name": "@hubspot/cli",
-    "version": "7.7.32-experimental.0",
+    "version": "7.7.33-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/local-dev-lib": "3.17.0",
-        "@hubspot/project-parsing-lib": "0.8.2",
+        "@hubspot/local-dev-lib": "3.18.0",
+        "@hubspot/project-parsing-lib": "0.8.3",
         "@hubspot/serverless-dev-runtime": "7.0.6",
         "@hubspot/theme-preview-dev-server": "0.0.10",
         "@hubspot/ui-extensions-dev-server": "0.9.8",

package/types/LocalDev.d.ts

@@ -1,4 +1,4 @@
-import { IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/src/lib/types.js';
+import { HSProfileVariables, IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/src/lib/types.js';
 import { Environment } from '@hubspot/local-dev-lib/types/Config';
 import { ValueOf } from '@hubspot/local-dev-lib/types/Utils';
 import { ProjectConfig } from './Projects.js';
@@ -16,6 +16,7 @@ export type LocalDevStateConstructorOptions = {
     initialProjectNodes: {
         [key: string]: IntermediateRepresentationNodeLocalDev;
     };
+    initialProjectProfileData: HSProfileVariables;
     env: Environment;
 };
 export type LocalDevWebsocketMessage = {

package/types/Projects.d.ts

@@ -10,6 +10,7 @@ export type ComponentTemplate = {
     path: string;
     label: string;
     type: string;
+    cliSelector?: string;
     parentComponent?: string;
     supportedAuthTypes?: string[];
     supportedDistributions?: string[];