Theia API Documentation v1.77.0
    Preparing search index...
    interface PromptService {
        onPromptsChange: Event<void>;
        onSelectedVariantChange: Event<
            { promptVariantSetId: string; variantId: string
            | undefined },
        >;
        addBuiltInPromptFragment(
            promptFragment: BasePromptFragment,
            promptVariantSetId?: string,
            isDefault?: boolean,
        ): void;
        createBuiltInCustomization(fragmentId: string): Promise<void>;
        createCustomization(fragmentId: string): Promise<void>;
        editBuiltInCustomization(fragmentId: string): Promise<void>;
        editCustomization(
            fragmentId: string,
            customizationId: string,
        ): Promise<void>;
        getActivePromptFragments(): PromptFragment[];
        getAllPromptFragments(): Map<string, PromptFragment[]>;
        getBuiltInRawPrompt(fragmentId: string): PromptFragment | undefined;
        getCommands(agentId?: string): PromptFragment[];
        getCustomizationDescription(
            fragmentId: string,
            customizationId: string,
        ): Promise<string | undefined>;
        getCustomizationType(
            fragmentId: string,
            customizationId: string,
        ): Promise<string | undefined>;
        getDefaultVariantId(promptVariantSetId: string): string | undefined;
        getEffectiveVariantId(promptVariantSetId: string): string | undefined;
        getPromptFragment(fragmentId: string): PromptFragment | undefined;
        getPromptFragmentByCommandName(
            commandName: string,
        ): PromptFragment | undefined;
        getPromptVariantInfo(
            fragmentId: string,
            modeId?: string,
        ): PromptVariantInfo | undefined;
        getPromptVariantSets(): Map<string, string[]>;
        getRawPromptFragment(fragmentId: string): PromptFragment | undefined;
        getResolvedPromptFragment(
            fragmentId: string,
            args?: { [key: string]: unknown },
            context?: AIVariableContext,
        ): Promise<ResolvedPromptFragment | undefined>;
        getResolvedPromptFragmentWithoutFunctions(
            fragmentId: string,
            args?: { [key: string]: unknown },
            context?: AIVariableContext,
            resolveVariable?: (
                variable: AIVariableArg,
            ) => Promise<ResolvedAIVariable | undefined>,
        ): Promise<
            Omit<ResolvedPromptFragment, "functionDescriptions">
            | undefined,
        >;
        getSelectedVariantId(promptVariantSetId: string): string | undefined;
        getTemplateIDFromResource(resourceId: unknown): string | undefined;
        getVariantIds(promptVariantSetId: string): string[];
        isKnownCommand(name: string): boolean;
        removeCustomization(
            fragmentId: string,
            customizationId: string,
        ): Promise<void>;
        removePromptFragment(fragmentId: string): void;
        resetAllToBuiltIn(): Promise<void>;
        resetToBuiltIn(fragmentId: string): Promise<void>;
        resetToCustomization(
            fragmentId: string,
            customizationId: string,
        ): Promise<void>;
        updateSelectedVariantId(
            agentId: string,
            promptVariantSetId: string,
            newVariant: string,
        ): Promise<void>;
    }

    Implemented by

    Index
    onPromptsChange: Event<void>

    Event fired when the prompts change

    onSelectedVariantChange: Event<
        { promptVariantSetId: string; variantId: string
        | undefined },
    >

    Event fired when the selected variant for a prompt variant set changes

    • Adds a prompt fragment to the service

      Parameters

      • promptFragment: BasePromptFragment

        The fragment to store

      • OptionalpromptVariantSetId: string

        Optional ID of the prompt variant set this is a variant of

      • OptionalisDefault: boolean

      Returns void

    • The following methods delegate to the PromptFragmentCustomizationService

      Parameters

      • fragmentId: string

      Returns Promise<void>

    • Parameters

      • fragmentId: string
      • customizationId: string

      Returns Promise<void>

    • Gets all prompt fragments marked as commands, optionally filtered by agent

      Parameters

      • OptionalagentId: string

        Optional agent ID to filter commands (undefined returns commands for all agents)

      Returns PromptFragment[]

      Array of command prompt fragments

    • Parameters

      • fragmentId: string
      • customizationId: string

      Returns Promise<string | undefined>

    • Parameters

      • fragmentId: string
      • customizationId: string

      Returns Promise<string | undefined>

    • Gets the default variant ID of the given set

      Parameters

      • promptVariantSetId: string

        The prompt variant set id

      Returns string | undefined

      The default variant ID or undefined if no default is set

    • Gets the effective variant ID that is guaranteed to be valid if one exists. This checks if the selected variant ID is valid, and falls back to the default variant if it isn't.

      Parameters

      • promptVariantSetId: string

        The prompt variant set id

      Returns string | undefined

      A valid variant ID if one exists, or undefined if no valid variant can be found

    • Gets a prompt fragment by command name (for slash commands)

      Parameters

      • commandName: string

        The command name to search for

      Returns PromptFragment | undefined

      The fragment with the matching command name or undefined if not found

    • Gets the effective variant ID and customization state for a prompt fragment. This is a convenience method that combines getEffectiveVariantId and customization check.

      Parameters

      • fragmentId: string

        The prompt fragment ID or variant set ID

      • OptionalmodeId: string

        Optional mode ID to use as variant override (if it's a valid variant for the fragment)

      Returns PromptVariantInfo | undefined

      The variant info or undefined if no valid variant exists

    • Gets all prompt variant sets and their variants

      Returns Map<string, string[]>

      Map of prompt variant set IDs to arrays of variant IDs

    • Resolves a prompt fragment by replacing variables and function references

      Parameters

      • fragmentId: string

        The prompt fragment ID

      • Optionalargs: { [key: string]: unknown }

        Optional object with values for variable replacement

      • Optionalcontext: AIVariableContext

        Optional context for variable resolution

      Returns Promise<ResolvedPromptFragment | undefined>

      The resolved prompt fragment or undefined if not found

    • Resolves a prompt fragment by replacing variables but preserving function references

      Parameters

      • fragmentId: string

        The prompt fragment ID

      • Optionalargs: { [key: string]: unknown }

        Optional object with values for variable replacement

      • Optionalcontext: AIVariableContext

        Optional context for variable resolution

      • OptionalresolveVariable: (variable: AIVariableArg) => Promise<ResolvedAIVariable | undefined>

        Optional custom variable resolution function

      Returns Promise<Omit<ResolvedPromptFragment, "functionDescriptions"> | undefined>

      The partially resolved prompt fragment or undefined if not found

    • Gets the explicitly selected variant ID for a prompt fragment from settings. This returns only the variant that was explicitly selected in settings, not the default.

      Parameters

      • promptVariantSetId: string

        The prompt variant set id

      Returns string | undefined

      The selected variant ID from settings, or undefined if none is selected

    • Returns all IDs of all prompt fragments of the given set

      Parameters

      • promptVariantSetId: string

        The prompt variant set id

      Returns string[]

      Array of variant IDs

    • Checks whether /name can be resolved as a slash command.

      This mirrors the lookup performed when resolving the prompt variable: the name may either be the command name of a fragment marked as a command, or the id of any existing prompt fragment. Use this before interpreting a /name token as a command, so that unrelated text such as Unix paths is not mistaken for a command.

      Parameters

      • name: string

        The command name or prompt fragment id

      Returns boolean

      true if a matching command or prompt fragment exists

    • Parameters

      • fragmentId: string
      • customizationId: string

      Returns Promise<void>

    • Removes a prompt fragment from the service

      Parameters

      • fragmentId: string

        The fragment ID to remove

      Returns void

    • Parameters

      • fragmentId: string
      • customizationId: string

      Returns Promise<void>

    • Updates the selected variant for a prompt variant set

      Parameters

      • agentId: string

        The ID of the agent to update

      • promptVariantSetId: string

        The prompt variant set ID

      • newVariant: string

        The new variant ID to set as selected

      Returns Promise<void>