Set Default Theme

Instructions

Implementation Reference

• src/tools/themes/setDefaultTheme.ts:10-82 (handler)

  The main tool definition and handler for setDefaultTheme. Defines the tool name, input schema (realm, themeIdentifier), and the toolFunction that fetches the theme config, finds the theme by ID/name, sets all isDefault to false except the target, and PUTs the updated config back.

  export const setDefaultThemeTool = {
    name: 'setDefaultTheme',
    title: 'Set Default Theme',
    description: 'Set a theme as the default for a realm in PingOne AIC',
    scopes: SCOPES,
    annotations: {
      destructiveHint: false,
      idempotentHint: true,
      openWorldHint: true
    },
    inputSchema: {
      realm: z.enum(REALMS).describe('Realm name'),
      themeIdentifier: safePathSegmentSchema.describe('Theme ID or name')
    },
    async toolFunction({ realm, themeIdentifier }: { realm: string; themeIdentifier: string }) {
      try {
        // Get the current theme configuration
        const configUrl = `https://${aicBaseUrl}/openidm/config/ui/themerealm`;
        const { data: config } = await makeAuthenticatedRequest(configUrl, SCOPES);
  
        // Validate config structure
        if (!config || !(config as any).realm || !(config as any).realm[realm]) {
          return createToolResponse(`Invalid theme configuration structure for realm "${realm}"`);
        }
  
        const realmThemes = (config as any).realm[realm];
  
        // Find the theme by ID or name
        const themeIndex = realmThemes.findIndex((t: any) => t._id === themeIdentifier || t.name === themeIdentifier);
  
        if (themeIndex === -1) {
          return createToolResponse(`Theme not found: "${themeIdentifier}" in realm "${realm}"`);
        }
  
        const targetTheme = realmThemes[themeIndex];
        const themeName = targetTheme.name;
        const themeId = targetTheme._id;
  
        // Check if it's already the default
        if (targetTheme.isDefault === true) {
          return createToolResponse(`Theme "${themeName}" is already the default theme for realm "${realm}"`);
        }
  
        // Set all themes to isDefault: false, then set target to true
        const updatedThemes = realmThemes.map((theme: any, index: number) => ({
          ...theme,
          isDefault: index === themeIndex
        }));
  
        // Update the config
        const updatedConfig = {
          ...config,
          realm: {
            ...(config as any).realm,
            [realm]: updatedThemes
          }
        };
  
        // PUT the updated configuration back
        const { response } = await makeAuthenticatedRequest(configUrl, SCOPES, {
          method: 'PUT',
          body: JSON.stringify(updatedConfig)
        });
  
        const successMessage = `Set theme "${themeName}" (${themeId}) as default for realm "${realm}"`;
        return createToolResponse(
          formatSuccess({ _id: themeId, name: themeName, isDefault: true, message: successMessage }, response)
        );
      } catch (error: any) {
        return createToolResponse(`Failed to set default theme in realm "${realm}": ${error.message}`);
      }
    }
  };

• src/tools/themes/setDefaultTheme.ts:20-23 (schema)

  Input schema for the setDefaultTheme tool: realm (from enum REALMS) and themeIdentifier (safe path segment).

  inputSchema: {
    realm: z.enum(REALMS).describe('Realm name'),
    themeIdentifier: safePathSegmentSchema.describe('Theme ID or name')
  },

• src/tools/themes/index.ts:8-8 (registration)

  Re-exports the setDefaultThemeTool from setDefaultTheme.ts as part of the theme tools index.

  export { setDefaultThemeTool } from './setDefaultTheme.js';

• src/tools/themes/updateTheme.ts:40-43 (helper)

  Guard in updateTheme that prevents updating isDefault directly and directs users to use setDefaultTheme instead.

  if ('isDefault' in themeUpdates) {
    return createToolResponse(
      'Cannot update "isDefault" directly. Use the setDefaultTheme tool to change the default theme.'
    );

• src/tools/themes/deleteTheme.ts:48-52 (helper)

  Guard in deleteTheme that prevents deleting the default theme and directs users to use setDefaultTheme first.

  if (themeToDelete.isDefault === true) {
    return createToolResponse(
      `Cannot delete the default theme "${themeName}". ` +
        `Set another theme as default using the setDefaultTheme tool first, then delete this theme.`
    );