// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.

import { CommandHandlerContext } from "../context/commandHandlerContext.js";
import registerDebug from "debug";
import { ExecutableAction, getPropertyInfo, MatchOptions } from "agent-cache";
import {
    CompletionDirection,
    CompletionGroup,
    CompletionGroups,
    TypeAgentAction,
} from "@typeagent/agent-sdk";
import { DeepPartialUndefined } from "@typeagent/common-utils";
import {
    ActionParamType,
    ActionResolvedParamType,
    CompletionEmojis,
    getPropertyType,
    resolveTypeReference,
} from "@typeagent/action-schema";
import { getAppAgentName } from "./agentTranslators.js";
import { resolveEntityTypeName } from "../execute/pendingActions.js";
import {
    getActivityActiveSchemas,
    getActivityCacheSpec,
    getActivityNamespaceSuffix,
    getNonActivityActiveSchemas,
} from "./matchRequest.js";
import { getHistoryContext } from "./interpretRequest.js";
import {
    getActionSchema,
    tryGetActionSchemaParameterType,
} from "./actionSchemaUtils.js";
import { getParamPatternValue } from "./actionSchemaFileCache.js";

const debugCompletion = registerDebug("typeagent:request:completion");
const debugCompletionError = registerDebug(
    "typeagent:request:completion:error",
);

function getCompletionNamespaceKeys(context: CommandHandlerContext): string[] {
    const cache = context.agentCache;
    const activeSchemaNames = context.agents.getActiveSchemas();
    const activityContext = context.activityContext;
    if (activityContext === undefined) {
        return cache.getNamespaceKeys(activeSchemaNames, undefined);
    }

    const cacheSpec = getActivityCacheSpec(context, activityContext);
    if (cacheSpec === false) {
        // activity cache is disable, only return non-activity completions.
        return cache.getNamespaceKeys(
            getNonActivityActiveSchemas(activeSchemaNames, activityContext),
            undefined,
        );
    }
    const namespaceSuffix = getActivityNamespaceSuffix(
        context,
        activityContext,
    );

    if (namespaceSuffix === undefined) {
        return cache.getNamespaceKeys(activeSchemaNames, undefined);
    }
    return cache
        .getNamespaceKeys(
            getActivityActiveSchemas(activeSchemaNames, activityContext),
            namespaceSuffix,
        )
        .concat(
            cache.getNamespaceKeys(
                getNonActivityActiveSchemas(activeSchemaNames, activityContext),
                undefined,
            ),
        );
}

export async function requestCompletion(
    requestPrefix: string,
    context: CommandHandlerContext,
    direction?: CompletionDirection, // defaults to forward-like behavior when omitted
): Promise<CompletionGroups> {
    debugCompletion(`Request completion for prefix: '${requestPrefix}'`);
    const namespaceKeys = getCompletionNamespaceKeys(context);
    debugCompletion(`Request completion namespace keys`, namespaceKeys);

    const config = context.session.getConfig();
    const options: MatchOptions = {
        wildcard: config.cache.matchWildcard,
        rejectReferences: config.explainer.filter.reference.list,
        namespaceKeys,
        history: getHistoryContext(context),
    };
    const results = context.agentCache.completion(
        requestPrefix,
        options,
        direction,
    );

    if (results === undefined) {
        return { groups: [] };
    }

    const matchedPrefixLength = results.matchedPrefixLength;
    const separatorMode = results.separatorMode;
    const closedSet = results.closedSet;
    const directionSensitive = results.directionSensitive;
    const openWildcard = results.openWildcard;
    const completions: CompletionGroup[] = [];
    if (results.completions.length > 0) {
        completions.push({
            name: "Request Completions",
            completions: results.completions,
            needQuotes: false, // Request completions are partial, no quotes needed
            kind: "literal",
        });
    }

    if (results.properties === undefined) {
        return {
            groups: completions,
            matchedPrefixLength,
            separatorMode,
            closedSet,
            directionSensitive,
            openWildcard,
        };
    }

    const propertyCompletions = new Map<string, CompletionGroup>();
    for (const completionProperty of results.properties) {
        // TODO: assuming the partial action doesn't change the possible values.
        const propertyNames = completionProperty.names.filter(
            (name) => !propertyCompletions.has(name),
        );
        if (propertyNames.length > 0) {
            await collectActionCompletions(
                propertyNames,
                completionProperty.actions,
                context,
                propertyCompletions,
            );
        }
    }

    completions.push(...propertyCompletions.values());
    return {
        groups: completions,
        matchedPrefixLength,
        separatorMode,
        closedSet,
        directionSensitive,
        openWildcard,
    };
}

async function collectActionCompletions(
    properties: string[],
    partialActions: ExecutableAction[],
    context: CommandHandlerContext,
    propertyCompletions: Map<string, CompletionGroup>,
) {
    for (const propertyName of properties) {
        const { action, parameterName } = getPropertyInfo(
            propertyName,
            partialActions,
        );

        if (parameterName === undefined) {
            // The part is for the fullActionName, can't do completion for this part.
            continue;
        }

        const paramCompletion = await getActionParamCompletion(
            context,
            action,
            parameterName,
        );

        if (paramCompletion !== undefined) {
            propertyCompletions.set(propertyName, {
                name: `property ${propertyName}`,
                ...paramCompletion,
                needQuotes: false, // Request completions are partial, no quotes needed
                sorted: true, // REVIEW: assume property completions are already in desired order by the agent.
                kind: "entity",
            });
        }
    }
}

export async function getActionParamCompletion(
    systemContext: CommandHandlerContext,
    partialAction: DeepPartialUndefined<TypeAgentAction>,
    parameterName: string,
): Promise<
    { completions: string[]; emojiChar: string | undefined } | undefined
> {
    const { schemaName, actionName } = partialAction;
    if (schemaName === undefined || actionName === undefined) {
        return undefined;
    }

    debugCompletion(
        `Getting action completion for ${schemaName}.${actionName} parameter ${parameterName}`,
    );

    // Having action schema means it is a FullAction
    const action = partialAction as TypeAgentAction;
    let actionCompletion: string[] | undefined;
    let fieldType: ActionParamType | undefined;
    let resolvedFieldType: ActionResolvedParamType | undefined;
    let literalCompletion: string[] | undefined;

    const agents = systemContext.agents;
    const actionSchemaFile = agents.tryGetActionSchemaFile(schemaName);
    let entityCompletionEmojis: CompletionEmojis | undefined;
    let paramCompletionEmojis: CompletionEmojis | undefined;
    if (actionSchemaFile !== undefined) {
        const actionSchema = getActionSchema(actionSchemaFile, actionName);
        const actionParametersType = tryGetActionSchemaParameterType(
            actionSchemaFile,
            actionName,
            actionSchema,
        );
        if (actionParametersType !== undefined) {
            fieldType = getPropertyType(actionParametersType, parameterName);
            resolvedFieldType = resolveTypeReference(fieldType);
        }
        switch (resolvedFieldType?.type) {
            case "string-union":
                literalCompletion = [...resolvedFieldType.typeEnum];
                break;
            case "type-union":
                const literals = [];
                for (const type of resolvedFieldType.types) {
                    if (type.type === "string-union") {
                        literals.push(...type.typeEnum);
                    }
                }
                literalCompletion = literals.length > 0 ? literals : undefined;
                break;
        }

        paramCompletionEmojis = actionSchema.paramCompletionEmojis;
        entityCompletionEmojis = actionSchema.entityCompletionEmojis;
    }

    let entityEmojiChar: string | undefined;
    const appAgentName = getAppAgentName(schemaName);
    const appAgent = agents.getAppAgent(appAgentName);
    if (appAgent.getActionCompletion !== undefined) {
        const entitySchemas =
            actionSchemaFile?.parsedActionSchema.entitySchemas;
        const entityTypeName =
            fieldType && resolvedFieldType && entitySchemas
                ? resolveEntityTypeName(
                      fieldType,
                      resolvedFieldType,
                      entitySchemas,
                  )
                : undefined;

        if (entityTypeName) {
            entityEmojiChar = getParamPatternValue(
                entityCompletionEmojis,
                entityTypeName,
            );
        }
        const sessionContext = agents.getSessionContext(appAgentName);
        try {
            actionCompletion = await appAgent.getActionCompletion(
                sessionContext,
                action,
                `parameters.${parameterName}`,
                entityTypeName,
            );
        } catch (e: any) {
            // If the agent completion fails, just ignore it.
            debugCompletionError(
                `Error getting action completion for ${action.schemaName}.${action.actionName} parameter ${parameterName}: ${e.message}`,
            );
        }
    }

    const completions = literalCompletion
        ? actionCompletion
            ? literalCompletion.concat(actionCompletion)
            : literalCompletion
        : actionCompletion;

    return completions === undefined || completions.length === 0
        ? undefined
        : {
              completions,
              emojiChar:
                  entityEmojiChar ??
                  getParamPatternValue(paramCompletionEmojis, parameterName),
          };
}
