// *****************************************************************************
// Copyright (C) 2025 EclipseSource GmbH.
//
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License v. 2.0 which is available at
// http://www.eclipse.org/legal/epl-2.0.
//
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License v. 2.0 are satisfied: GNU General Public License, version 2
// with the GNU Classpath Exception which is available at
// https://www.gnu.org/software/classpath/license.html.
//
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
// *****************************************************************************

import { nls } from '@theia/core';
import { ConfirmDialog, ReactWidget, codicon } from '@theia/core/lib/browser';
import { inject, injectable, postConstruct } from '@theia/core/shared/inversify';
import {
    CustomizedPromptFragment,
    PromptFragment,
    isCustomizedPromptFragment,
    isBasePromptFragment,
    PromptService,
    BasePromptFragment
} from '@theia/ai-core/lib/common/prompt-service';
import * as React from '@theia/core/shared/react';
import { AgentService } from '@theia/ai-core/lib/common/agent-service';
import { Agent } from '@theia/ai-core/lib/common/agent';
import { CustomizationSource } from '@theia/ai-core/lib/browser/frontend-prompt-customization-service';
import { isChatAgent } from '@theia/ai-chat/';

/**
 * Widget for configuring AI prompt fragments and prompt variant sets.
 * Allows users to view, create, edit, and manage various types of prompt
 * fragments including their customizations and variants.
 */
@injectable()
export class AIPromptFragmentsConfigurationWidget extends ReactWidget {

    static readonly ID = 'ai-prompt-fragments-configuration';
    static readonly LABEL = nls.localize('theia/ai/core/promptFragmentsConfiguration/label', 'Prompt Fragments');

    /**
     * Stores all available prompt fragments by ID
     */
    protected promptFragmentMap: Map<string, PromptFragment[]> = new Map<string, PromptFragment[]>();

    /**
     * Stores prompt variant sets and their variant IDs
     */
    protected promptVariantsMap: Map<string, string[]> = new Map<string, string[]>();

    /**
     * Currently active prompt fragments
     */
    protected activePromptFragments: PromptFragment[] = [];

    /**
     * Tracks expanded state of prompt fragment sections in the UI
     */
    protected expandedPromptFragmentIds: Set<string> = new Set();

    /**
     * Tracks expanded state of prompt content display
     */
    protected expandedPromptFragmentTemplates: Set<string> = new Set();

    /**
     * Tracks expanded state of prompt variant set sections
     */
    protected expandedPromptVariantSetIds: Set<string> = new Set();

    /**
     * All available agents that may use prompts
     */
    protected availableAgents: Agent[] = [];

    /**
     * Maps prompt variant set IDs to their resolved variant IDs
     */
    protected effectiveVariantIds: Map<string, string | undefined> = new Map();

    /**
     * Maps prompt variant set IDs to their default variant IDs
     */
    protected defaultVariantIds: Map<string, string | undefined> = new Map();

    /**
     * Maps prompt variant set IDs to their user selected variant IDs
     */
    protected userSelectedVariantIds: Map<string, string | undefined> = new Map();

    @inject(PromptService) protected promptService: PromptService;
    @inject(AgentService) protected agentService: AgentService;

    @postConstruct()
    protected init(): void {
        this.id = AIPromptFragmentsConfigurationWidget.ID;
        this.title.label = AIPromptFragmentsConfigurationWidget.LABEL;
        this.title.caption = AIPromptFragmentsConfigurationWidget.LABEL;
        this.title.closable = true;
        this.addClass('ai-configuration-tab-content');
        this.loadPromptFragments();
        this.loadAgents();

        this.toDispose.pushAll([
            this.promptService.onPromptsChange(() => {
                this.loadPromptFragments();
            }),
            this.agentService.onDidChangeAgents(() => {
                this.loadAgents();
            })
        ]);
    }

    /**
     * Loads all prompt fragments and prompt variant sets from the prompt service.
     * Preserves UI expansion states and updates variant information.
     */
    protected loadPromptFragments(): void {
        this.promptFragmentMap = this.promptService.getAllPromptFragments();
        this.promptVariantsMap = this.promptService.getPromptVariantSets();
        this.activePromptFragments = this.promptService.getActivePromptFragments();

        // Preserve expansion state when reloading
        const existingExpandedFragmentIds = new Set(this.expandedPromptFragmentIds);
        const existingExpandedPromptVariantIds = new Set(this.expandedPromptVariantSetIds);
        const existingExpandedTemplates = new Set(this.expandedPromptFragmentTemplates);

        if (existingExpandedFragmentIds.size > 0) {
            // Keep existing expansion state but remove entries for fragments that no longer exist
            this.expandedPromptFragmentIds = new Set(
                Array.from(existingExpandedFragmentIds).filter(id => this.promptFragmentMap.has(id))
            );
        }

        if (existingExpandedPromptVariantIds.size === 0) {
            // Start with variant sets collapsed by default
            this.expandedPromptVariantSetIds = new Set();
        } else {
            // Keep existing expansion state but remove entries for prompt variant sets that no longer exist
            this.expandedPromptVariantSetIds = new Set(
                Array.from(existingExpandedPromptVariantIds).filter(id => this.promptVariantsMap.has(id))
            );
        }

        // For templates, preserve existing expanded states - don't expand by default
        this.expandedPromptFragmentTemplates = new Set(
            Array.from(existingExpandedTemplates).filter(id => {
                const [fragmentId] = id.split('_');
                return this.promptFragmentMap.has(fragmentId);
            })
        );

        // Update variant information (selected/default/effective) for prompt variant sets
        for (const promptVariantSetId of this.promptVariantsMap.keys()) {
            const effectiveId = this.promptService.getEffectiveVariantId(promptVariantSetId);
            const defaultId = this.promptService.getDefaultVariantId(promptVariantSetId);
            const selectedId = this.promptService.getSelectedVariantId(promptVariantSetId) ?? defaultId;
            this.userSelectedVariantIds.set(promptVariantSetId, selectedId);
            this.effectiveVariantIds.set(promptVariantSetId, effectiveId);
            this.defaultVariantIds.set(promptVariantSetId, defaultId);
        }

        this.update();
    }

    /**
     * Loads all available agents from the agent service
     */
    protected loadAgents(): void {
        this.availableAgents = this.agentService.getAllAgents();
        this.update();
    }

    /**
     * Finds agents that use a specific prompt variant set
     * @param promptVariantSetId ID of the prompt variant set to match
     * @returns Array of agents that use the prompt variant set
     */
    protected getAgentsUsingPromptVariantId(promptVariantSetId: string): Agent[] {
        return this.availableAgents.filter((agent: Agent) =>
            agent.prompts.find(promptVariantSet => promptVariantSet.id === promptVariantSetId)
        );
    }

    protected togglePromptVariantSetExpansion = (promptVariantSetId: string): void => {
        if (this.expandedPromptVariantSetIds.has(promptVariantSetId)) {
            this.expandedPromptVariantSetIds.delete(promptVariantSetId);
        } else {
            this.expandedPromptVariantSetIds.add(promptVariantSetId);
        }
        this.update();
    };

    protected togglePromptFragmentExpansion = (promptFragmentId: string): void => {
        if (this.expandedPromptFragmentIds.has(promptFragmentId)) {
            this.expandedPromptFragmentIds.delete(promptFragmentId);
        } else {
            this.expandedPromptFragmentIds.add(promptFragmentId);
        }
        this.update();
    };

    protected toggleTemplateExpansion = (fragmentKey: string, event: React.MouseEvent): void => {
        event.stopPropagation();
        if (this.expandedPromptFragmentTemplates.has(fragmentKey)) {
            this.expandedPromptFragmentTemplates.delete(fragmentKey);
        } else {
            this.expandedPromptFragmentTemplates.add(fragmentKey);
        }
        this.update();
    };

    /**
     * Call the edit action for the provided customized prompt fragment
     * @param promptFragment Fragment to edit
     * @param event Mouse event
     */
    protected editPromptCustomization = (promptFragment: CustomizedPromptFragment, event: React.MouseEvent): void => {
        event.stopPropagation();
        this.promptService.editCustomization(promptFragment.id, promptFragment.customizationId);
    };

    /**
     * Determines if a prompt fragment is currently the active one for its ID
     * @param promptFragment The prompt fragment to check
     * @returns True if this prompt fragment is the active customization
     */
    protected isActiveCustomization(promptFragment: PromptFragment): boolean {
        const activePromptFragment = this.activePromptFragments.find(activePrompt => activePrompt.id === promptFragment.id);
        if (!activePromptFragment) {
            return false;
        }

        if (isCustomizedPromptFragment(activePromptFragment) && isCustomizedPromptFragment(promptFragment)) {
            return (
                activePromptFragment.id === promptFragment.id &&
                activePromptFragment.template === promptFragment.template &&
                activePromptFragment.customizationId === promptFragment.customizationId &&
                activePromptFragment.priority === promptFragment.priority
            );
        }

        if (isBasePromptFragment(activePromptFragment) && isBasePromptFragment(promptFragment)) {
            return (
                activePromptFragment.id === promptFragment.id &&
                activePromptFragment.template === promptFragment.template
            );
        }

        return false;
    }

    /**
     * Resets a prompt fragment to use a specific customization (with confirmation dialog)
     * @param customization customization to reset to
     * @param event Mouse event
     */
    protected resetToPromptFragment = async (customization: PromptFragment, event: React.MouseEvent): Promise<void> => {
        event.stopPropagation();

        if (isCustomizedPromptFragment(customization)) {
            // Get the customization type to show in the confirmation dialog
            const type = await this.promptService.getCustomizationType(customization.id, customization.customizationId);

            const dialog = new ConfirmDialog({
                title: nls.localize('theia/ai/core/promptFragmentsConfiguration/resetToCustomizationDialogTitle', 'Reset to Customization'),
                msg: nls.localize('theia/ai/core/promptFragmentsConfiguration/resetToCustomizationDialogMsg',
                    'Are you sure you want to reset the prompt fragment "{0}" to use the {1} customization? This will remove all higher-priority customizations.',
                    customization.id, type),
                ok: nls.localizeByDefault('Reset'),
                cancel: nls.localizeByDefault('Cancel')
            });

            const shouldReset = await dialog.open();
            if (shouldReset) {
                await this.promptService.resetToCustomization(customization.id, customization.customizationId);
            }
        } else {
            const dialog = new ConfirmDialog({
                title: nls.localize('theia/ai/core/promptFragmentsConfiguration/resetToBuiltInDialogTitle', 'Reset to Built-in'),
                msg: nls.localize('theia/ai/core/promptFragmentsConfiguration/resetToBuiltInDialogMsg',
                    'Are you sure you want to reset the prompt fragment "{0}" to its built-in version? This will remove all customizations.', customization.id),
                ok: nls.localizeByDefault('Reset'),
                cancel: nls.localizeByDefault('Cancel')
            });

            const shouldReset = await dialog.open();
            if (shouldReset) {
                await this.promptService.resetToBuiltIn(customization.id);
            }
        }
    };

    /**
     * Creates a new customization for a built-in prompt fragment
     * @param promptFragment Built-in prompt fragment to customize
     * @param event Mouse event
     */
    protected createPromptFragmentCustomization = (promptFragment: BasePromptFragment, event: React.MouseEvent): void => {
        event.stopPropagation();
        this.promptService.createBuiltInCustomization(promptFragment.id);
    };

    /**
     * Deletes a customization with confirmation dialog
     * @param customization Customized prompt fragment to delete
     * @param event Mouse event
     */
    protected deletePromptFragmentCustomization = async (customization: CustomizedPromptFragment, event: React.MouseEvent): Promise<void> => {
        event.stopPropagation();

        // First get the customization type and description to show in the confirmation dialog
        const type = await this.promptService.getCustomizationType(customization.id, customization.customizationId) || '';
        const description = await this.promptService.getCustomizationDescription(customization.id, customization.customizationId) || '';

        const dialog = new ConfirmDialog({
            title: nls.localize('theia/ai/core/promptFragmentsConfiguration/removeCustomizationDialogTitle', 'Remove Customization'),
            msg: description ?
                nls.localize('theia/ai/core/promptFragmentsConfiguration/removeCustomizationWithDescDialogMsg',
                    'Are you sure you want to remove the {0} customization for prompt fragment "{1}" ({2})?', type, customization.id, description) :
                nls.localize('theia/ai/core/promptFragmentsConfiguration/removeCustomizationDialogMsg',
                    'Are you sure you want to remove the {0} customization for prompt fragment "{1}"?', type, customization.id),
            ok: nls.localizeByDefault('Remove'),
            cancel: nls.localizeByDefault('Cancel')
        });

        const shouldDelete = await dialog.open();
        if (shouldDelete) {
            await this.promptService.removeCustomization(customization.id, customization.customizationId);
        }
    };

    /**
     * Removes all prompt customizations (resets to built-in versions) with confirmation
     */
    protected removeAllCustomizations = async (): Promise<void> => {
        const dialog = new ConfirmDialog({
            title: nls.localize('theia/ai/core/promptFragmentsConfiguration/resetAllCustomizationsDialogTitle', 'Reset All Customizations'),
            msg: nls.localize('theia/ai/core/promptFragmentsConfiguration/resetAllCustomizationsDialogMsg',
                'Are you sure you want to reset all prompt fragments to their built-in versions? This will remove all customizations.'),
            ok: nls.localize('theia/ai/core/promptFragmentsConfiguration/resetAllButton', 'Reset All'),
            cancel: nls.localizeByDefault('Cancel')
        });

        const shouldReset = await dialog.open();
        if (shouldReset) {
            this.promptService.resetAllToBuiltIn();
        }
    };

    /**
     * Main render method for the widget
     * @returns Complete UI for the configuration widget
     */
    protected render(): React.ReactNode {
        const nonSystemPromptFragments = this.getNonPromptVariantSetFragments();

        return (
            <div className='ai-prompt-fragments-configuration'>
                <div className="prompt-fragments-header">
                    <h2>{nls.localize('theia/ai/core/promptFragmentsConfiguration/headerTitle', 'Prompt Fragments')}</h2>
                    <div className="global-actions">
                        <button
                            className="global-action-button"
                            onClick={this.removeAllCustomizations}
                            title={nls.localize('theia/ai/core/promptFragmentsConfiguration/resetAllCustomizationsTitle', 'Reset all customizations')}
                        >
                            {nls.localize('theia/ai/core/promptFragmentsConfiguration/resetAllPromptFragments',
                                'Reset all prompt fragments')} <span className={codicon('clear-all')}></span>
                        </button>
                    </div>
                </div>

                <div className="prompt-variants-container">
                    <h3 className="section-header">{nls.localize('theia/ai/core/promptFragmentsConfiguration/promptVariantsHeader', 'Prompt Variant Sets')}</h3>
                    {Array.from(this.promptVariantsMap.entries()).sort((a, b) => a[0].localeCompare(b[0])).map(([promptVariantSetId, variantIds]) =>
                        this.renderPromptVariantSet(promptVariantSetId, variantIds)
                    )}
                </div>

                {nonSystemPromptFragments.size > 0 && <div className="prompt-fragments-container">
                    <h3 className="section-header">{nls.localize('theia/ai/core/promptFragmentsConfiguration/otherPromptFragmentsHeader', 'Other Prompt Fragments')}</h3>
                    {Array.from(nonSystemPromptFragments.entries()).sort((a, b) => a[0].localeCompare(b[0])).map(([promptFragmentId, fragments]) =>
                        this.renderPromptFragment(promptFragmentId, fragments)
                    )}
                </div>}

                {this.promptFragmentMap.size === 0 && (
                    <div className="no-fragments">
                        <p>{nls.localize('theia/ai/core/promptFragmentsConfiguration/noFragmentsAvailable', 'No prompt fragments available.')}</p>
                    </div>
                )}
            </div>
        );
    }

    /**
     * Renders a prompt variant set with its variants
     * @param promptVariantSetId ID of the prompt variant set
     * @param variantIds Array of variant IDs
     * @returns React node for the prompt variant set group
     */
    protected renderPromptVariantSet(promptVariantSetId: string, variantIds: string[]): React.ReactNode {
        const isSectionExpanded = this.expandedPromptVariantSetIds.has(promptVariantSetId);

        // Get selected, effective, and default variant IDs from our class properties
        const selectedVariantId = this.userSelectedVariantIds.get(promptVariantSetId);
        const effectiveVariantId = this.effectiveVariantIds.get(promptVariantSetId);
        const defaultVariantId = this.defaultVariantIds.get(promptVariantSetId);

        // Get variant fragments grouped by ID
        const variantGroups = new Map<string, PromptFragment[]>();

        // First, collect all actual fragments for each variant ID
        for (const variantId of variantIds) {
            if (this.promptFragmentMap.has(variantId)) {
                variantGroups.set(variantId, this.promptFragmentMap.get(variantId)!);
            }
        }

        const relatedAgents = this.getAgentsUsingPromptVariantId(promptVariantSetId);

        // Determine warning/error state
        let variantSetMessage: React.ReactNode | undefined = undefined;
        if (effectiveVariantId === undefined) {
            // Error: effectiveId is undefined, so nothing works
            variantSetMessage = (
                <div className="prompt-variant-error">
                    <span className="codicon codicon-error"></span>
                    {nls.localize('theia/ai/core/promptFragmentsConfiguration/variantSetError',
                        'The selected variant does not exist and no default could be found. Please check your configuration.')}
                </div>
            );
        } else {
            const needsWarning = selectedVariantId ? effectiveVariantId !== selectedVariantId : effectiveVariantId !== defaultVariantId;
            if (needsWarning) {
                // Warning: selectedId is set but does not exist, so default is used
                variantSetMessage = (
                    <div className="prompt-variant-warning">
                        <span className="codicon codicon-warning"></span>
                        {nls.localize('theia/ai/core/promptFragmentsConfiguration/variantSetWarning',
                            'The selected variant does not exist. The default variant is being used instead.')}
                    </div>
                );
            }
        }

        return (
            <div className="prompt-fragment-section" key={`variant-${promptVariantSetId}`}>
                <div
                    className={`prompt-fragment-header ${isSectionExpanded ? 'expanded' : ''}`}
                    onClick={() => this.togglePromptVariantSetExpansion(promptVariantSetId)}
                >
                    <div className="prompt-fragment-title">
                        <span className="expansion-icon">{isSectionExpanded ? '▼' : '▶'}</span>
                        <h2>{promptVariantSetId}</h2>
                    </div>
                    {relatedAgents.length > 0 && (
                        <div className="agent-chips-container">
                            {relatedAgents.map(agent => (
                                <span key={agent.id} className="agent-chip"
                                    title={nls.localize('theia/ai/core/promptFragmentsConfiguration/usedByAgentTitle', 'Used by agent: {0}', agent.name)}
                                    onClick={e => e.stopPropagation()}>
                                    <span className={(isChatAgent(agent) && agent.iconClass) ? agent.iconClass : codicon('copilot')}></span>
                                    {agent.name}
                                </span>
                            ))}
                        </div>
                    )}
                </div>
                {isSectionExpanded && (
                    <div className="prompt-fragment-body">
                        {variantSetMessage}
                        <div className="prompt-fragment-description">
                            <p>{nls.localize('theia/ai/core/promptFragmentsConfiguration/variantsOfSystemPrompt', 'Variants of this prompt variant set:')}</p>
                        </div>
                        {Array.from(variantGroups.entries()).map(([variantId, fragments]) => {
                            const isVariantExpanded = this.expandedPromptFragmentIds.has(variantId);

                            return (
                                <div key={variantId} className={`prompt-fragment-section ${selectedVariantId === variantId ? 'selected-variant' : ''}`}>
                                    <div
                                        className={`prompt-fragment-header ${isVariantExpanded ? 'expanded' : ''}`}
                                        onClick={() => this.togglePromptFragmentExpansion(variantId)}
                                    >
                                        <div className="prompt-fragment-title">
                                            <span className="expansion-icon">{isVariantExpanded ? '▼' : '▶'}</span>
                                            <h4>{variantId}</h4>
                                            {defaultVariantId === variantId && (
                                                <span className="badge default-variant"
                                                    title={nls.localize('theia/ai/core/promptFragmentsConfiguration/defaultVariantTitle', 'Default variant')}>
                                                    {nls.localizeByDefault('Default')}
                                                </span>
                                            )}
                                            {selectedVariantId === variantId && (
                                                <span className="selected-indicator"
                                                    title={nls.localize('theia/ai/core/promptFragmentsConfiguration/selectedVariantTitle', 'Selected variant')}>
                                                    {nls.localize('theia/ai/core/promptFragmentsConfiguration/selectedVariantLabel', 'Selected')}
                                                </span>
                                            )}
                                        </div>
                                    </div>
                                    {isVariantExpanded && (
                                        <div className='prompt-fragment-body'>
                                            {fragments.map(fragment => this.renderPromptFragmentCustomization(fragment))}
                                        </div>
                                    )}
                                </div>
                            );
                        })}
                    </div>
                )}
            </div>
        );
    }

    /**
     * Gets fragments that aren't part of any prompt variant set
     * @returns Map of fragment IDs to their customizations
     */
    protected getNonPromptVariantSetFragments(): Map<string, PromptFragment[]> {
        const nonSystemPromptFragments = new Map<string, PromptFragment[]>();
        const allVariantIds = new Set<string>();

        // Collect all variant IDs from prompt variant sets
        this.promptVariantsMap.forEach((variants, _) => {
            variants.forEach(variantId => allVariantIds.add(variantId));
        });

        // Add prompt variant set main IDs
        this.promptVariantsMap.forEach((_, promptVariantSetId) => {
            allVariantIds.add(promptVariantSetId);
        });

        // Filter the fragment map to only include non-prompt variant set fragments
        this.promptFragmentMap.forEach((fragments, promptFragmentId) => {
            if (!allVariantIds.has(promptFragmentId)) {
                nonSystemPromptFragments.set(promptFragmentId, fragments);
            }
        });

        return nonSystemPromptFragments;
    }

    /**
     * Renders a prompt fragment with all of its customizations
     * @param promptFragmentId ID of the prompt fragment
     * @param customizations Array of the customizations
     * @returns React node for the prompt fragment
     */
    protected renderPromptFragment(promptFragmentId: string, customizations: PromptFragment[]): React.ReactNode {
        const isSectionExpanded = this.expandedPromptFragmentIds.has(promptFragmentId);

        return (
            <div className={'prompt-fragment-group'} key={promptFragmentId}>
                <div
                    className={`prompt-fragment-header ${isSectionExpanded ? 'expanded' : ''}`}
                    onClick={() => this.togglePromptFragmentExpansion(promptFragmentId)}
                >
                    <div className="prompt-fragment-title">
                        <span className="expansion-icon">{isSectionExpanded ? '▼' : '▶'}</span>
                        {promptFragmentId}
                    </div>
                </div>
                {isSectionExpanded && (
                    <div className="prompt-fragment-body">
                        {customizations.map(fragment => this.renderPromptFragmentCustomization(fragment))}
                    </div>
                )}
            </div>
        );
    }

    /**
     * Renders a single prompt fragment customization with its controls and content
     * @param promptFragment The prompt fragment to render
     * @returns React node for the prompt fragment
     */
    protected renderPromptFragmentCustomization(promptFragment: PromptFragment): React.ReactNode {
        const isCustomized = isCustomizedPromptFragment(promptFragment);
        const isActive = this.isActiveCustomization(promptFragment);
        // Create a unique key for this fragment to track expansion state
        const fragmentKey = `${promptFragment.id}_${isCustomized ? promptFragment.customizationId : 'built-in'}`;
        const isTemplateExpanded = this.expandedPromptFragmentTemplates.has(fragmentKey);
        const hasCustomizedBuiltIn =
            this.promptFragmentMap.get(promptFragment.id)?.some(fragment => isCustomizedPromptFragment(fragment) && fragment.priority === CustomizationSource.CUSTOMIZED);

        return (
            <div
                className={`prompt-customization ${isActive ? 'active-customization' : ''}`}
                key={fragmentKey}
            >
                <div className="prompt-customization-header">
                    <div className="prompt-customization-title">
                        <React.Suspense fallback={<div>Loading...</div>}>
                            <CustomizationTypeBadge promptFragment={promptFragment} promptService={this.promptService} />
                        </React.Suspense>
                        {isActive && (
                            <span className="active-indicator"
                                title={nls.localize('theia/ai/core/promptFragmentsConfiguration/activeCustomizationTitle', 'Active customization')}>
                                {nls.localizeByDefault('Active')}
                            </span>
                        )}
                    </div>
                    <div className="prompt-customization-actions">
                        {!isCustomized && !hasCustomizedBuiltIn && (
                            <button
                                className="template-action-button config-button"
                                onClick={e => this.createPromptFragmentCustomization(promptFragment, e)}
                                title={nls.localize('theia/ai/core/promptFragmentsConfiguration/createCustomizationTitle', 'Create Customization')}
                            >
                                <span className={codicon('add')}></span>
                            </button>
                        )}
                        {isCustomized && (
                            <button
                                className="source-uri-button"
                                onClick={e => this.editPromptCustomization(promptFragment, e)}
                                title={nls.localize('theia/ai/core/promptFragmentsConfiguration/editTemplateTitle', 'Edit template')}
                            >
                                <span className={codicon('edit')}></span>
                            </button>
                        )}
                        {!isActive && (
                            <button
                                className="template-action-button reset-button"
                                onClick={e => this.resetToPromptFragment(promptFragment, e)}
                                title={!isCustomized ?
                                    nls.localize('theia/ai/core/promptFragmentsConfiguration/resetToBuiltInTitle', 'Reset to this built-in') :
                                    nls.localize('theia/ai/core/promptFragmentsConfiguration/resetToCustomizationTitle', 'Reset to this customization')}
                            >
                                <span className={codicon('discard')}></span>
                            </button>
                        )}
                        {isCustomized && (
                            <button
                                className="template-action-button delete-button"
                                onClick={e => this.deletePromptFragmentCustomization(promptFragment, e)}
                                title={nls.localize('theia/ai/core/promptFragmentsConfiguration/deleteCustomizationTitle', 'Delete Customization')}
                            >
                                <span className={codicon('trash')}></span>
                            </button>
                        )}
                    </div>
                </div>

                {isCustomized && (
                    <React.Suspense fallback={<div>Loading...</div>}>
                        <DescriptionBadge promptFragment={promptFragment} promptService={this.promptService} />
                    </React.Suspense>
                )}

                <div className="template-content-container">
                    <div
                        className="template-toggle-button"
                        onClick={e => this.toggleTemplateExpansion(fragmentKey, e)}
                    >
                        <span className="template-expansion-icon">{isTemplateExpanded ? '▼' : '▶'}</span>
                        <span>{nls.localize('theia/ai/core/promptFragmentsConfiguration/promptTemplateText', 'Prompt Template Text')}</span>
                    </div>

                    {isTemplateExpanded && (
                        <div className="template-content">
                            <pre>{promptFragment.template}</pre>
                        </div>
                    )}
                </div>
            </div>
        );
    }
}

/**
 * Props for the CustomizationTypeBadge component
 */
interface CustomizationTypeBadgeProps {
    promptFragment: PromptFragment;
    promptService: PromptService;
}

/**
 * Displays a badge indicating the type of a prompt fragment customization (built-in, user, workspace)
 */
const CustomizationTypeBadge: React.FC<CustomizationTypeBadgeProps> = ({ promptFragment, promptService }) => {
    const [typeLabel, setTypeLabel] = React.useState<string>('unknown');

    React.useEffect(() => {
        const fetchCustomizationType = async () => {
            if (isCustomizedPromptFragment(promptFragment)) {
                const customizationType = await promptService.getCustomizationType(promptFragment.id, promptFragment.customizationId);
                setTypeLabel(`${customizationType ?
                    customizationType + ' ' + nls.localize('theia/ai/core/promptFragmentsConfiguration/customization', 'customization')
                    : nls.localize('theia/ai/core/promptFragmentsConfiguration/customizationLabel', 'Customization')}`);
            } else {
                setTypeLabel(nls.localizeByDefault('Built-in'));
            }
        };

        fetchCustomizationType();
    }, [promptFragment, promptService]);

    return <span>{typeLabel}</span>;
};

/**
 * Props for the DescriptionBadge component
 */
interface CustomizationDescriptionBadgeProps {
    promptFragment: CustomizedPromptFragment;
    promptService: PromptService;
}

/**
 * Displays the description of a customized prompt fragment if available
 */
const DescriptionBadge: React.FC<CustomizationDescriptionBadgeProps> = ({ promptFragment, promptService }) => {
    const [description, setDescription] = React.useState<string>('');

    React.useEffect(() => {
        const fetchDescription = async () => {
            const customizationDescription = await promptService.getCustomizationDescription(
                promptFragment.id,
                promptFragment.customizationId
            );
            setDescription(customizationDescription || '');
        };

        fetchDescription();
    }, [promptFragment.id, promptFragment.customizationId, promptService]);

    return <span className="prompt-customization-description">{description}</span>;
};
