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

import { getFileExtensionForMimeType } from "typechat-utils";
import {
    DeepPartialUndefined,
    DeepPartialUndefinedAndNull,
} from "@typeagent/common-utils";
import { CacheConfig, AgentCache, getDefaultExplainerName } from "agent-cache";
import { getSessionGrammarStorePath } from "action-grammar";
import registerDebug from "debug";
import fs from "node:fs";
import path from "node:path";
import { getUniqueFileName, getYMDPrefix } from "../utils/fsUtils.js";
import ExifReader from "exifreader";
import {
    AppAgentStateConfig,
    appAgentStateKeys,
} from "./appAgentStateConfig.js";
import {
    cloneConfig,
    isEmptySettings,
    mergeConfig,
    sanitizeConfig,
} from "./options.js";
import { TokenCounter, TokenCounterData } from "aiclient";
import { DispatcherName } from "./dispatcher/dispatcherUtils.js";
import { ConstructionProvider } from "../agentProvider/agentProvider.js";
import { MultipleActionConfig } from "../translation/multipleActionSchema.js";
import { IndexManager } from "./indexManager.js";
import { IndexingServiceRegistry } from "./indexingServiceRegistry.js";
import { IndexData } from "image-memory";

const debugSession = registerDebug("typeagent:session");

type Sessions = {
    lastSession?: string;
};

function getSessionsFilePath(instanceDir: string) {
    return path.join(instanceDir, "sessions.json");
}

export function getSessionsDirPath(instanceDir: string) {
    return path.join(instanceDir, "sessions");
}

export function getSessionDirPath(instanceDir: string, dir: string) {
    return path.join(getSessionsDirPath(instanceDir), dir);
}

function getSessionDataFilePath(sessionDirPath: string) {
    return path.join(sessionDirPath, "data.json");
}

export function getSessionConstructionDirPath(sessionDirPath: string) {
    return path.join(sessionDirPath, "constructions");
}

async function loadSessions(instanceDir: string): Promise<Sessions> {
    const sessionFilePath = getSessionsFilePath(instanceDir);
    if (fs.existsSync(sessionFilePath)) {
        const content = await fs.promises.readFile(sessionFilePath, "utf-8");
        return JSON.parse(content);
    }
    return {};
}

async function newSessionDir(instanceDir: string) {
    const sessions = await loadSessions(instanceDir);
    const dir = getUniqueFileName(
        getSessionsDirPath(instanceDir),
        getYMDPrefix(),
    );
    const fullDir = getSessionDirPath(instanceDir, dir);
    await fs.promises.mkdir(fullDir, { recursive: true });
    sessions.lastSession = dir;
    await fs.promises.writeFile(
        getSessionsFilePath(instanceDir),
        JSON.stringify(sessions, undefined, 2),
    );
    debugSession(`New session: ${dir}`);
    return fullDir;
}

/**
 * Per session configuration to control various features of the dispatcher.
 */
export type DispatcherConfig = {
    // the agent that handles NLP requests
    request: string;

    // Translation configurations
    translation: {
        enabled: boolean;
        model: string;
        stream: boolean;
        promptConfig: {
            additionalInstructions: boolean;
        };
        switch: {
            fixed: string; // fixed first schema to use, ignore embedding if set
            embedding: boolean; // use embedding to determine the first schema to use.
            inline: boolean;
            search: boolean;
        };
        multiple: MultipleActionConfig;
        history: {
            enabled: boolean;
            limit: number; // number of entities,
        };
        schema: {
            generation: {
                enabled: boolean;
                jsonSchema: boolean;
                jsonSchemaFunction: boolean;
                jsonSchemaWithTs: boolean; // only applies when jsonSchema or jsonSchemaFunction is true
                jsonSchemaValidate: boolean; // only applies when jsonSchema or jsonSchemaFunction is true
            };
            optimize: {
                enabled: boolean;
                numInitialActions: number; // 0 means no limit
            };
        };
        entity: {
            resolve: boolean; // resolve entities in the request
            clarify: boolean; // clarify entity names when multiple entities match
            filter: boolean;
            // Path-navigation resolution for entity placeholders in action
            // parameters. Extends the `${entity-N}` form with dotted property
            // access — `${entity-0.facets[0].value}` — by walking the entity
            // object. Four modes:
            //  • "off":              current behavior — only the bare regex form is
            //                        resolved; anything else passes through as a
            //                        literal string.
            //  • "throw":            attempt path navigation; throw a descriptive
            //                        error if the path does not resolve. Strictest —
            //                        feeds a named error into the reasoning loop.
            //  • "fallback-to-name": attempt path navigation; if the path misses,
            //                        resolve the bare form (entity.name) instead.
            //  • "passthrough":      attempt path navigation; if the path misses,
            //                        leave the literal placeholder untouched
            //                        (equivalent to "off" for that specific miss).
            // Shape-agnostic: if the entity schema grows a new field, the LLM's
            // path guess resolves automatically — no code change here.
            pathNavigation:
                | "off"
                | "throw"
                | "fallback-to-name"
                | "passthrough";
        };
    };

    // Execution configurations
    execution: {
        history: boolean;
        activity: boolean;
        planReuse: "enabled" | "disabled"; // workflow plan reuse for reasoning actions
        scriptReuse: "enabled" | "disabled"; // PowerShell script reuse for reasoning actions
        memory: {
            legacy: boolean; // use legacy memory behavior
        };
        reasoning: "claude" | "copilot" | "none";
        // When true, the dispatcher's pre-flight readiness gate auto-invokes
        // `AppAgent.setup` on agents reporting `setup-required` — instead of
        // throwing the "needs setup" error. The setup hook's ActionResult is
        // surfaced (any in-chat yes/no card included), and the user's
        // original action/command is *not* automatically retried — the user
        // re-runs it after setup completes.
        // Default: true. Once an agent population has setup hooks, the
        // strict-error path becomes the worse UX (user sees a hint, has
        // to copy/paste a command, gets the card they would have got
        // anyway). Toggle off via @config execution setupOnFirstUse off
        // for environments that prefer explicit setup invocations
        // (CI / scripted / agents-as-libraries).
        setupOnFirstUse: boolean;
        // Controls how Entity objects are rendered into LLM prompts (translation + reasoning context).
        // "facets" (default): current shape `{id, name, type, facets: [{name, value}, ...]}`.
        // "flat": collapse facets into a `properties` object — `{id, name, type, uniqueId?, properties: {...}}`.
        // "facets-with-schema": same JSON as "facets", but the Entity/EntityFacet TS type is appended to the reasoning system prompt.
        entityPromptShape: "facets" | "flat" | "facets-with-schema";
    };
    explainer: {
        enabled: boolean;
        model: string;
        name: string;
        filter: {
            multiple: boolean;
            reference: {
                value: boolean;
                list: boolean;
                translate: boolean;
            };
        };
    };

    // Cache behaviors
    cache: CacheConfig & {
        enabled: boolean;
        grammar: boolean;
        grammarSystem: "completionBased" | "nfa"; // Which grammar system to use for matching
        useDFA: boolean; // Use DFA within the NFA grammar system (faster matching; requires grammarSystem=nfa)
        autoSave: boolean;
        builtInCache: boolean;
        matchWildcard: boolean;
        matchEntityWildcard: boolean;
    };

    // Action collision detection. Defaults preserve current behavior — everything off,
    // strategies are "first-match" (today's silent winner-take-all). Opt-in per detection
    // point. See docs/architecture and packages/dispatcher/.../matchCollision.ts.
    collision: CollisionConfig;

    // Additional instructions appended to the reasoning system prompt.
    // Set this in the session config to inject dispatcher-level guidance without modifying source.
    promptAppend?: string;
};

export type CollisionStrategy =
    | "first-match"
    | "score-rank"
    | "priority"
    | "user-clarify";

export type CollisionConfig = {
    static: {
        detect: boolean;
        // "error" only honored on initial addProvider; the async onSchemaReady path
        // always degrades to "warn" so a slow agent can never crash a live session.
        strategy: "warn" | "error";
    };
    grammarMatch: {
        detect: boolean;
        // distinctActions: collision iff >1 distinct (schemaName, actionName) tuples
        // tiedHeuristics: collision iff top two share matchedCount + nonOptionalCount + wildcardCharCount
        classifier: "distinctActions" | "tiedHeuristics";
        strategy: CollisionStrategy;
    };
    llmSelect: {
        detect: boolean;
        topN: number;
        scoreDeltaThreshold: number;
        strategy: CollisionStrategy;
    };
    fuzzy: {
        detect: boolean;
        staticEnabled: boolean;
        runtimeEnabled: boolean;
        similarityThreshold: number;
        // "placeholder" returns 0 for all pairs — default and inert.
        // "actionEmbedding" is reserved for a follow-up; selecting it now logs
        // a "not implemented; falling back to placeholder" warning.
        scorer: "placeholder" | "actionEmbedding";
        strategy: CollisionStrategy;
    };
    // Optional explicit ranking — comma-separated agent names (e.g. "list,music,player").
    // Stored as a string because the dispatcher config system rejects arrays.
    // Empty / unset falls back to agent registration order.
    priorityOrder: string;
    // What user-clarify does inside a MultipleAction batch.
    multipleActionBehavior:
        | "downgrade-to-priority"
        | "pause-and-prompt"
        | "abort";
    telemetry: {
        emit: boolean;
        debugLog: boolean;
        // Tester-set tag for grouping events into an experiment window
        // (e.g. "E1.2-2026-05-12").  Auto-copied into every emitted
        // CollisionEvent so Cosmos queries can slice by experiment without
        // joining other tables.  Empty string is the unset sentinel
        // (mirrors `priorityOrder` — the dispatcher config layer rejects
        // `undefined`-valued fields).
        experimentId: string;
    };
};

export type SessionConfig = AppAgentStateConfig & DispatcherConfig;
export type SessionSettings = DeepPartialUndefined<SessionConfig>;
export type SessionOptions = DeepPartialUndefinedAndNull<SessionConfig> | null;
export type SessionChanged = DeepPartialUndefined<SessionConfig> | undefined;

const defaultSessionConfig: SessionConfig = {
    schemas: {},
    actions: {},
    commands: {},

    // default to dispatcher
    request: DispatcherName,
    translation: {
        enabled: true,
        model: "",
        stream: true,
        promptConfig: {
            additionalInstructions: true,
        },
        switch: {
            fixed: "",
            embedding: true,
            inline: true,
            search: true,
        },
        multiple: {
            enabled: true,
            result: true,
            pending: true,
        },
        history: {
            enabled: true,
            limit: 20,
        },
        schema: {
            generation: {
                enabled: true,
                jsonSchema: false,
                jsonSchemaFunction: false,
                jsonSchemaWithTs: false,
                jsonSchemaValidate: true,
            },
            optimize: {
                enabled: false,
                numInitialActions: 5,
            },
        },
        entity: {
            resolve: true,
            filter: true,
            clarify: false, // TODO: enable when it is ready.
            // Default "fallback-to-name": path navigation is ON, and an
            // unresolvable path silently substitutes entity.name (with a
            // debug-log line via the typeagent:dispatcher:actions:entities
            // namespace). This lets the action dispatch with a slightly-
            // wrong-but-not-fatal value so the existing reasoning fallback
            // can recover, instead of aborting the whole conversation at
            // translation time. Set to "throw" to restore the strict mode
            // that fails fast on a path miss, "off" to disable path navigation
            // entirely, or "passthrough" to leave the literal placeholder.
            pathNavigation: "fallback-to-name",
        },
    },
    execution: {
        history: true,
        activity: false, // TODO: experimental.
        planReuse: "disabled", // default: workflow plan reuse disabled (opt-in)
        scriptReuse: "disabled", // default: script reuse disabled (opt-in)
        memory: {
            legacy: true, // use the new memory behavior
        },
        reasoning: "none",
        setupOnFirstUse: true,
        // Default set based on the entity-shape experiment (bench-results/entity-shape-experiment.md):
        // appending the Entity TS type to the reasoning system prompt produced 4 consistent
        // gains / 0 consistent regressions on a 20-test sample (median of 3 runs).
        entityPromptShape: "facets-with-schema",
    },
    explainer: {
        enabled: true,
        model: "",
        name: getDefaultExplainerName(),
        filter: {
            multiple: true,
            reference: {
                value: true,
                list: true,
                translate: true,
            },
        },
    },
    cache: {
        enabled: true,
        grammar: true,
        grammarSystem: "completionBased", // default to completion-based grammar system
        useDFA: false, // DFA is opt-in; NFA is the default within the NFA grammar system
        autoSave: true,
        mergeMatchSets: true, // the session default is different then the default in the cache
        cacheConflicts: true, // the session default is different then the default in the cache
        matchWildcard: true,
        matchEntityWildcard: true,
        builtInCache: true,
    },
    collision: {
        static: {
            detect: false,
            strategy: "warn",
        },
        grammarMatch: {
            detect: false,
            classifier: "distinctActions",
            strategy: "first-match",
        },
        llmSelect: {
            detect: false,
            topN: 3,
            scoreDeltaThreshold: 0.05,
            strategy: "first-match",
        },
        fuzzy: {
            detect: false,
            staticEnabled: false,
            runtimeEnabled: false,
            similarityThreshold: 0.85,
            scorer: "placeholder",
            strategy: "first-match",
        },
        priorityOrder: "",
        multipleActionBehavior: "downgrade-to-priority",
        telemetry: {
            emit: false,
            debugLog: true,
            experimentId: "",
        },
    },
};

// explainer name as key, cache file path as value
type SessionCacheData = {
    [key: string]: string | undefined;
};

type SessionData = {
    settings?: SessionSettings | undefined;
    cacheData: SessionCacheData;
    tokens?: TokenCounterData;
    indexes?: IndexData[];
};

// Fill in missing fields when loading sessions from disk
function ensureSessionData(data: any): SessionData {
    if (data.config !== undefined) {
        // back compat
        data.settings = data.config;
    }

    if (data.settings !== undefined) {
        sanitizeConfig(defaultSessionConfig, data.settings, appAgentStateKeys);
    }
    if (data.cacheData === undefined) {
        data.cacheData = {};
    }
    return data;
}

export function getSessionName(dirPath: string) {
    return path.basename(dirPath);
}

const sessionVersion = 2;
async function readSessionData(dirPath: string) {
    const sessionDataFilePath = getSessionDataFilePath(dirPath);
    if (!fs.existsSync(sessionDataFilePath)) {
        const sessionName = getSessionName(dirPath);
        throw new Error(`Session '${sessionName}' does not exist.`);
    }
    const content = await fs.promises.readFile(sessionDataFilePath, "utf-8");
    const data = JSON.parse(content);
    if (data.version !== sessionVersion) {
        const sessionName = getSessionName(dirPath);
        throw new Error(
            `Unsupported session version (${data.version}) in '${sessionName}'`,
        );
    }
    return ensureSessionData(data);
}
export class Session {
    private readonly defaultConfig = cloneConfig(defaultSessionConfig);
    private readonly settings: SessionSettings;
    private config: SessionConfig;
    private cacheData: SessionCacheData;

    public static async create(
        settings?: SessionSettings,
        instanceDir?: string,
        indexingServiceRegistry?: IndexingServiceRegistry,
    ) {
        const session = new Session(
            { settings, cacheData: {} },
            instanceDir ? await newSessionDir(instanceDir) : undefined,
            indexingServiceRegistry,
        );
        await session.save();
        return session;
    }

    public static async load(
        instanceDir: string,
        dir: string,
        indexingServiceRegistry?: IndexingServiceRegistry,
    ) {
        const dirPath = getSessionDirPath(instanceDir, dir);
        const sessionData = await readSessionData(dirPath);
        debugSession(`Loading session: ${dir}`);
        debugSession(
            `Settings: ${JSON.stringify(sessionData.settings, undefined, 2)}`,
        );

        return new Session(sessionData, dirPath, indexingServiceRegistry);
    }

    public static async restoreLastSession(
        instanceDir: string,
        indexingServiceRegistry?: IndexingServiceRegistry,
    ) {
        const sessionDir = (await loadSessions(instanceDir))?.lastSession;
        if (sessionDir !== undefined) {
            try {
                return this.load(
                    instanceDir,
                    sessionDir,
                    indexingServiceRegistry,
                );
            } catch (e: any) {
                throw new Error(
                    `Unable to restore last session '${sessionDir}': ${e.message}`,
                );
            }
        }
        return undefined;
    }

    private constructor(
        sessionData: SessionData,
        public readonly sessionDirPath?: string,
        indexingServiceRegistry?: IndexingServiceRegistry,
    ) {
        this.settings = sessionData.settings ?? {};
        this.config = cloneConfig(defaultSessionConfig);
        mergeConfig(this.config, this.settings, appAgentStateKeys);
        this.cacheData = sessionData.cacheData;

        // rehydrate token stats
        if (sessionData.tokens) {
            TokenCounter.load(sessionData.tokens);
        }

        // rehydrate indexes
        if (sessionDirPath) {
            if (!sessionData.indexes) {
                sessionData.indexes = [];
            }

            // Pass the registry to IndexManager.load
            IndexManager.load(
                sessionData.indexes,
                sessionDirPath,
                indexingServiceRegistry,
            ).catch((error) => {
                console.warn(`Failed to load indexing services: ${error}`);
            });
        }
    }

    public get explainerName() {
        return this.config.explainer.name;
    }

    public get explanation() {
        return this.config.explainer.enabled;
    }

    public get cacheConfig(): CacheConfig {
        return {
            mergeMatchSets: this.config.cache.mergeMatchSets,
            cacheConflicts: this.config.cache.cacheConflicts,
        };
    }

    public getSettings(): Readonly<SessionSettings> {
        return this.settings;
    }

    public updateSettings(options: SessionOptions): SessionChanged {
        const changed = mergeConfig(this.settings, options, true);
        if (changed) {
            this.save();
        }
        return mergeConfig(
            this.config,
            options,
            appAgentStateKeys,
            this.defaultConfig,
        );
    }

    public getConfig(): Readonly<SessionConfig> {
        return this.config;
    }

    public updateConfig(settings: SessionSettings): SessionChanged {
        return mergeConfig(this.config, settings, appAgentStateKeys);
    }

    public updateDefaultConfig(settings: SessionSettings): SessionChanged {
        mergeConfig(this.defaultConfig, settings, appAgentStateKeys);
        // Get the latest configuration
        const newConfig = cloneConfig(this.defaultConfig);
        mergeConfig(newConfig, this.settings, appAgentStateKeys);
        return mergeConfig(this.config, newConfig, appAgentStateKeys);
    }

    public getSessionDirPath(): string | undefined {
        return this.sessionDirPath;
    }

    public getConstructionDataFilePath() {
        const filePath = this.cacheData[this.explainerName];

        return filePath && this.sessionDirPath && !path.isAbsolute(filePath)
            ? path.join(
                  getSessionConstructionDirPath(this.sessionDirPath),
                  filePath,
              )
            : filePath;
    }

    public setConstructionDataFilePath(
        filePath: string | undefined,
        explainerName?: string,
    ) {
        const filePathRel =
            filePath &&
            this.sessionDirPath &&
            path.isAbsolute(filePath) &&
            filePath.startsWith(
                getSessionConstructionDirPath(this.sessionDirPath),
            )
                ? path.relative(
                      getSessionConstructionDirPath(this.sessionDirPath),
                      filePath,
                  )
                : filePath;

        this.cacheData[explainerName ?? this.explainerName] = filePathRel;

        this.save();
    }

    public async ensureCacheDataFilePath() {
        const filePath = this.getConstructionDataFilePath();
        return filePath ?? this.newCacheDataFilePath();
    }

    public getGrammarStoreFilePath(): string | undefined {
        return this.sessionDirPath
            ? getSessionGrammarStorePath(this.sessionDirPath)
            : undefined;
    }

    public async clear() {
        if (this.sessionDirPath) {
            await fs.promises.rm(this.sessionDirPath, {
                recursive: true,
                force: true,
            });
            await fs.promises.mkdir(this.sessionDirPath, { recursive: true });
            this.cacheData = {};
            await this.save();
        }
    }

    private async newCacheDataFilePath() {
        if (this.sessionDirPath) {
            const cacheDir = getSessionConstructionDirPath(this.sessionDirPath);
            await fs.promises.mkdir(cacheDir, { recursive: true });
            const filePath = getUniqueFileName(
                cacheDir,
                `${this.explainerName}_${getYMDPrefix()}`,
                ".json",
            );
            this.setConstructionDataFilePath(filePath);
            return path.join(cacheDir, filePath);
        }
        return undefined;
    }

    public save() {
        if (this.sessionDirPath) {
            const sessionDataFilePath = getSessionDataFilePath(
                this.sessionDirPath,
            );
            const data = {
                version: sessionVersion,
                settings: isEmptySettings(this.settings)
                    ? undefined
                    : this.settings,
                cacheData: this.cacheData,
                tokens: TokenCounter.getInstance(),
                indexes: IndexManager.getInstance().indexes,
            };
            debugSession(
                `Saving session: ${getSessionName(this.sessionDirPath)}`,
            );
            debugSession(
                `Settings: ${JSON.stringify(data.settings, undefined, 2)}`,
            );
            fs.writeFileSync(
                sessionDataFilePath,
                JSON.stringify(data, undefined, 2),
            );
        }
    }

    public async storeUserSuppliedFile(
        file: string,
    ): Promise<[string, ExifReader.Tags]> {
        if (this.sessionDirPath === undefined) {
            throw new Error("Unable to store file without persisting session");
        }

        const filesDir = path.join(this.sessionDirPath, "user_files");
        await fs.promises.mkdir(filesDir, { recursive: true });

        // get the extension for the  mime type for the supplied file
        const fileExtension: string = getFileExtensionForMimeType(
            file.substring(5, file.indexOf(";")),
        );
        const uniqueFileName: string = getUniqueFileName(
            filesDir,
            "attachment_",
            fileExtension,
        );
        const fileName: string = path.join(filesDir, uniqueFileName);
        const buffer = Buffer.from(
            file.substring(file.indexOf(";base64,") + ";base64,".length),
            "base64",
        );

        const tags: ExifReader.Tags = ExifReader.load(buffer);

        fs.writeFile(fileName, buffer, () => {});

        return [uniqueFileName, tags];
    }
}

/**
 * Clear existing cache state and setup the cache again.
 */
export async function setupAgentCache(
    session: Session,
    agentCache: AgentCache,
    provider?: ConstructionProvider,
    agentGrammarRegistry?: any, // Optional registry to reset when using NFA
) {
    const config = session.getConfig();
    agentCache.model = config.explainer.model;
    agentCache.constructionStore.clear();

    if (config.cache.enabled) {
        // If using NFA grammar system, reset dynamic grammar rules when enabling cache
        // This prevents double reset when @const new does disable→enable sequence
        if (config.cache.grammarSystem === "nfa" && agentGrammarRegistry) {
            agentGrammarRegistry.resetAllToBase();

            // Clear persisted grammar store file
            const grammarStorePath = session.getGrammarStoreFilePath();
            if (grammarStorePath && fs.existsSync(grammarStorePath)) {
                await fs.promises.unlink(grammarStorePath);
                debugSession(`Cleared grammar store at ${grammarStorePath}`);
            }
        }
        const cacheData = session.getConstructionDataFilePath();
        if (cacheData !== undefined) {
            // Load if there is an existing path.
            if (fs.existsSync(cacheData)) {
                debugSession(`Loading session cache from ${cacheData}`);
                await agentCache.constructionStore.load(cacheData);
            } else {
                debugSession(`Cache file missing ${cacheData}`);
                // Disable the cache if we can't load the file.
                session.updateSettings({ cache: { enabled: false } });
                throw new Error(
                    `Cache file ${cacheData} missing. Use '@const new' to create a new one'`,
                );
            }
        } else {
            // Create if there isn't an existing path.
            const newCacheData = config.cache.autoSave
                ? await session.ensureCacheDataFilePath()
                : undefined;
            await agentCache.constructionStore.newCache(newCacheData);
            debugSession(`Creating session cache ${newCacheData ?? ""}`);
        }

        await setupBuiltInCache(
            session,
            agentCache,
            config.cache.builtInCache,
            provider,
        );
    }
    await agentCache.constructionStore.setAutoSave(config.cache.autoSave);

    agentCache.grammarStore.setEnabled(config.cache.grammar);
}

export async function setupBuiltInCache(
    session: Session,
    agentCache: AgentCache,
    enable: boolean,
    provider?: ConstructionProvider,
) {
    const builtInConstructions = enable
        ? provider?.getBuiltinConstructionConfig(session.explainerName)?.file
        : undefined;

    try {
        await agentCache.constructionStore.setBuiltInCache(
            builtInConstructions,
        );
    } catch (e: any) {
        console.warn(`WARNING: Unable to load built-in cache: ${e.message}`);
    }
}

export async function deleteSession(instanceDir: string, dir: string) {
    if (dir === "") {
        return;
    }
    const sessionDir = getSessionDirPath(instanceDir, dir);
    return fs.promises.rm(sessionDir, { recursive: true, force: true });
}

export async function deleteAllSessions(instanceDir: string) {
    const sessionsDir = getSessionsDirPath(instanceDir);
    return fs.promises.rm(sessionsDir, { recursive: true, force: true });
}

export async function getSessionNames(instanceDir: string) {
    const sessionsDir = getSessionsDirPath(instanceDir);
    const dirent = await fs.promises.readdir(sessionsDir, {
        withFileTypes: true,
    });
    return dirent.filter((d) => d.isDirectory()).map((d) => d.name);
}

export async function getSessionConstructionDirPaths(dirPath: string) {
    const cacheDir = getSessionConstructionDirPath(dirPath);
    const dirent = await fs.promises.readdir(cacheDir, { withFileTypes: true });
    const sessionCacheData = (await readSessionData(dirPath))?.cacheData;
    const ret: {
        explainer: string;
        name: string;
        current: boolean;
    }[] = [];
    for (const d of dirent) {
        if (!d.isFile()) {
            continue;
        }

        try {
            const cacheContent = await fs.promises.readFile(
                path.join(cacheDir, d.name),
                "utf-8",
            );
            const cacheData = JSON.parse(cacheContent);
            ret.push({
                explainer: cacheData.explainerName,
                name: d.name,
                current: sessionCacheData?.[cacheData.explainerName] === d.name,
            });
        } catch {
            // ignore errors
        }
    }

    return ret;
}
