feat(admin): provide actionable error messages for disabled features (#17815)

packages/core/src/code_assist/admin/admin_controls.test.ts

@@ -17,8 +17,15 @@ import {
   fetchAdminControls,
   sanitizeAdminSettings,
   stopAdminControlsPolling,
+  getAdminErrorMessage,
 } from './admin_controls.js';
 import type { CodeAssistServer } from '../server.js';
+import type { Config } from '../../config/config.js';
+import { getCodeAssistServer } from '../codeAssist.js';
+
+vi.mock('../codeAssist.js', () => ({
+  getCodeAssistServer: vi.fn(),
+}));
 
 describe('Admin Controls', () => {
   let mockServer: CodeAssistServer;
@@ -370,6 +377,57 @@ describe('Admin Controls', () => {
 
       // The poll should not have fired again
       expect(mockServer.fetchAdminControls).toHaveBeenCalledTimes(1);
+      expect(mockServer.fetchAdminControls).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('getAdminErrorMessage', () => {
+    let mockConfig: Config;
+
+    beforeEach(() => {
+      mockConfig = {} as Config;
+    });
+
+    it('should include feature name and project ID when present', () => {
+      vi.mocked(getCodeAssistServer).mockReturnValue({
+        projectId: 'test-project-123',
+      } as CodeAssistServer);
+
+      const message = getAdminErrorMessage('Code Completion', mockConfig);
+
+      expect(message).toBe(
+        'Code Completion is disabled by your administrator. To enable it, please request an update to the settings at: https://goo.gle/manage-gemini-cli?project=test-project-123',
+      );
+    });
+
+    it('should include feature name but OMIT project ID when missing', () => {
+      vi.mocked(getCodeAssistServer).mockReturnValue({
+        projectId: undefined,
+      } as CodeAssistServer);
+
+      const message = getAdminErrorMessage('Chat', mockConfig);
+
+      expect(message).toBe(
+        'Chat is disabled by your administrator. To enable it, please request an update to the settings at: https://goo.gle/manage-gemini-cli',
+      );
+    });
+
+    it('should include feature name but OMIT project ID when server is undefined', () => {
+      vi.mocked(getCodeAssistServer).mockReturnValue(undefined);
+
+      const message = getAdminErrorMessage('Chat', mockConfig);
+
+      expect(message).toBe(
+        'Chat is disabled by your administrator. To enable it, please request an update to the settings at: https://goo.gle/manage-gemini-cli',
+      );
+    });
+
+    it('should include feature name but OMIT project ID when config is undefined', () => {
+      const message = getAdminErrorMessage('Chat', undefined);
+
+      expect(message).toBe(
+        'Chat is disabled by your administrator. To enable it, please request an update to the settings at: https://goo.gle/manage-gemini-cli',
+      );
     });
   });
 });

packages/core/src/code_assist/admin/admin_controls.ts

@@ -11,6 +11,8 @@ import {
   type FetchAdminControlsResponse,
   FetchAdminControlsResponseSchema,
 } from '../types.js';
+import { getCodeAssistServer } from '../codeAssist.js';
+import type { Config } from '../../config/config.js';
 
 let pollingInterval: NodeJS.Timeout | undefined;
 let currentSettings: FetchAdminControlsResponse | undefined;
@@ -132,3 +134,20 @@ export function stopAdminControlsPolling() {
     pollingInterval = undefined;
   }
 }
+
+/**
+ * Returns a standardized error message for features disabled by admin settings.
+ *
+ * @param featureName The name of the disabled feature
+ * @param config The application config
+ * @returns The formatted error message
+ */
+export function getAdminErrorMessage(
+  featureName: string,
+  config: Config | undefined,
+): string {
+  const server = config ? getCodeAssistServer(config) : undefined;
+  const projectId = server?.projectId;
+  const projectParam = projectId ? `?project=${projectId}` : '';
+  return `${featureName} is disabled by your administrator. To enable it, please request an update to the settings at: https://goo.gle/manage-gemini-cli${projectParam}`;
+}