@librechat/data-schemas 0.0.23 → 0.0.31

package/dist/index.es.js

@@ -1,1873 +1,2376 @@
-import { PermissionBits, FileSources, Constants, PermissionTypes, Permissions, SystemRoles, ResourceType, PrincipalType, PrincipalModel, roleDefaults, AccessRoleIds } from 'librechat-data-provider';
-import jwt from 'jsonwebtoken';
-import { webcrypto } from 'node:crypto';
-import mongoose, { Schema, Types } from 'mongoose';
+import { EModelEndpoint, agentsEndpointSchema, memorySchema, removeNullishValues, SafeSearchTypes, normalizeEndpointName, defaultAssistantsVersion, Capabilities, assistantEndpointSchema, validateAzureGroups, mapModelToAzureConfig, OCRStrategy, getConfigDefaults, PermissionBits, FileSources, Constants, PermissionTypes, Permissions, SystemRoles, ResourceType, PrincipalType, PrincipalModel, roleDefaults, AccessRoleIds } from 'librechat-data-provider';
 import winston from 'winston';
 import 'winston-daily-rotate-file';
 import { klona } from 'klona';
 import path from 'path';
+import jwt from 'jsonwebtoken';
+import { webcrypto } from 'node:crypto';
+import mongoose, { Schema, Types } from 'mongoose';
 import _ from 'lodash';
 import { MeiliSearch } from 'meilisearch';
 import { nanoid } from 'nanoid';
 
 /**
- * Common role combinations
+ * Sets up the Agents configuration from the config (`librechat.yaml`) file.
+ * If no agents config is defined, uses the provided defaults or parses empty object.
+ *
+ * @param config - The loaded custom configuration.
+ * @param [defaultConfig] - Default configuration from getConfigDefaults.
+ * @returns The Agents endpoint configuration.
  */
-var RoleBits;
-(function (RoleBits) {
-    /** 0001 = 1 */
-    RoleBits[RoleBits["VIEWER"] = PermissionBits.VIEW] = "VIEWER";
-    /** 0011 = 3 */
-    RoleBits[RoleBits["EDITOR"] = PermissionBits.VIEW | PermissionBits.EDIT] = "EDITOR";
-    /** 0111 = 7 */
-    RoleBits[RoleBits["MANAGER"] = PermissionBits.VIEW | PermissionBits.EDIT | PermissionBits.DELETE] = "MANAGER";
-    /** 1111 = 15 */
-    RoleBits[RoleBits["OWNER"] = PermissionBits.VIEW | PermissionBits.EDIT | PermissionBits.DELETE | PermissionBits.SHARE] = "OWNER";
-})(RoleBits || (RoleBits = {}));
+function agentsConfigSetup(config, defaultConfig) {
+    var _a;
+    const agentsConfig = (_a = config === null || config === void 0 ? void 0 : config.endpoints) === null || _a === void 0 ? void 0 : _a[EModelEndpoint.agents];
+    if (!agentsConfig) {
+        return defaultConfig || agentsEndpointSchema.parse({});
+    }
+    const parsedConfig = agentsEndpointSchema.parse(agentsConfig);
+    return parsedConfig;
+}
 
-async function signPayload({ payload, secret, expirationTime, }) {
-    return jwt.sign(payload, secret, { expiresIn: expirationTime });
+const hasValidAgent = (agent) => !!agent &&
+    (('id' in agent && !!agent.id) ||
+        ('provider' in agent && 'model' in agent && !!agent.provider && !!agent.model));
+const isDisabled = (config) => !config || config.disabled === true;
+function loadMemoryConfig(config) {
+    var _a;
+    if (!config)
+        return undefined;
+    if (isDisabled(config))
+        return config;
+    if (!hasValidAgent(config.agent)) {
+        return { ...config, disabled: true };
+    }
+    const charLimit = (_a = memorySchema.shape.charLimit.safeParse(config.charLimit).data) !== null && _a !== void 0 ? _a : 10000;
+    return { ...config, charLimit };
 }
-async function hashToken(str) {
-    const data = new TextEncoder().encode(str);
-    const hashBuffer = await webcrypto.subtle.digest('SHA-256', data);
-    return Buffer.from(hashBuffer).toString('hex');
+function isMemoryEnabled(config) {
+    if (isDisabled(config))
+        return false;
+    return hasValidAgent(config.agent);
 }
 
-// Define the Auth sub-schema with type-safety.
-const AuthSchema = new Schema({
-    authorization_type: { type: String },
-    custom_auth_header: { type: String },
-    type: { type: String, enum: ['service_http', 'oauth', 'none'] },
-    authorization_content_type: { type: String },
-    authorization_url: { type: String },
-    client_url: { type: String },
-    scope: { type: String },
-    token_exchange_method: { type: String, enum: ['default_post', 'basic_auth_header', null] },
-}, { _id: false });
-const Action = new Schema({
-    user: {
-        type: mongoose.Schema.Types.ObjectId,
-        ref: 'User',
-        index: true,
-        required: true,
-    },
-    action_id: {
-        type: String,
-        index: true,
-        required: true,
-    },
-    type: {
-        type: String,
-        default: 'action_prototype',
-    },
-    settings: Schema.Types.Mixed,
-    agent_id: String,
-    assistant_id: String,
-    metadata: {
-        api_key: String,
-        auth: AuthSchema,
-        domain: {
-            type: String,
-            required: true,
+/**
+ * Loads the default interface object.
+ * @param params - The loaded custom configuration.
+ * @param params.config - The loaded custom configuration.
+ * @param params.configDefaults - The custom configuration default values.
+ * @returns default interface object.
+ */
+async function loadDefaultInterface({ config, configDefaults, }) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+    const { interface: interfaceConfig } = config !== null && config !== void 0 ? config : {};
+    const { interface: defaults } = configDefaults;
+    const hasModelSpecs = ((_c = (_b = (_a = config === null || config === void 0 ? void 0 : config.modelSpecs) === null || _a === void 0 ? void 0 : _a.list) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) > 0;
+    const includesAddedEndpoints = ((_f = (_e = (_d = config === null || config === void 0 ? void 0 : config.modelSpecs) === null || _d === void 0 ? void 0 : _d.addedEndpoints) === null || _e === void 0 ? void 0 : _e.length) !== null && _f !== void 0 ? _f : 0) > 0;
+    const memoryConfig = config === null || config === void 0 ? void 0 : config.memory;
+    const memoryEnabled = isMemoryEnabled(memoryConfig);
+    /** Only disable memories if memory config is present but disabled/invalid */
+    const shouldDisableMemories = memoryConfig && !memoryEnabled;
+    const loadedInterface = removeNullishValues({
+        // UI elements - use schema defaults
+        endpointsMenu: (_g = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.endpointsMenu) !== null && _g !== void 0 ? _g : (hasModelSpecs ? false : defaults.endpointsMenu),
+        modelSelect: (_h = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.modelSelect) !== null && _h !== void 0 ? _h : (hasModelSpecs ? includesAddedEndpoints : defaults.modelSelect),
+        parameters: (_j = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.parameters) !== null && _j !== void 0 ? _j : (hasModelSpecs ? false : defaults.parameters),
+        presets: (_k = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.presets) !== null && _k !== void 0 ? _k : (hasModelSpecs ? false : defaults.presets),
+        sidePanel: (_l = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.sidePanel) !== null && _l !== void 0 ? _l : defaults.sidePanel,
+        privacyPolicy: (_m = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.privacyPolicy) !== null && _m !== void 0 ? _m : defaults.privacyPolicy,
+        termsOfService: (_o = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.termsOfService) !== null && _o !== void 0 ? _o : defaults.termsOfService,
+        mcpServers: (_p = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.mcpServers) !== null && _p !== void 0 ? _p : defaults.mcpServers,
+        customWelcome: (_q = interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.customWelcome) !== null && _q !== void 0 ? _q : defaults.customWelcome,
+        // Permissions - only include if explicitly configured
+        bookmarks: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.bookmarks,
+        memories: shouldDisableMemories ? false : interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.memories,
+        prompts: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.prompts,
+        multiConvo: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.multiConvo,
+        agents: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.agents,
+        temporaryChat: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.temporaryChat,
+        runCode: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.runCode,
+        webSearch: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.webSearch,
+        fileSearch: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.fileSearch,
+        fileCitations: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.fileCitations,
+        peoplePicker: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.peoplePicker,
+        marketplace: interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.marketplace,
+    });
+    return loadedInterface;
+}
+
+/**
+ * ESM-native object traversal utility
+ * Simplified implementation focused on the forEach use case
+ */
+function isObject(value) {
+    if (value === null || typeof value !== 'object') {
+        return false;
+    }
+    // Treat these built-in types as leaf nodes, not objects to traverse
+    if (value instanceof Date)
+        return false;
+    if (value instanceof RegExp)
+        return false;
+    if (value instanceof Error)
+        return false;
+    if (value instanceof URL)
+        return false;
+    // Check for Buffer (Node.js)
+    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value))
+        return false;
+    // Check for TypedArrays and ArrayBuffer
+    if (ArrayBuffer.isView(value))
+        return false;
+    if (value instanceof ArrayBuffer)
+        return false;
+    if (value instanceof SharedArrayBuffer)
+        return false;
+    // Check for other built-in types that shouldn't be traversed
+    if (value instanceof Promise)
+        return false;
+    if (value instanceof WeakMap)
+        return false;
+    if (value instanceof WeakSet)
+        return false;
+    if (value instanceof Map)
+        return false;
+    if (value instanceof Set)
+        return false;
+    // Check if it's a primitive wrapper object
+    const stringTag = Object.prototype.toString.call(value);
+    if (stringTag === '[object Boolean]' ||
+        stringTag === '[object Number]' ||
+        stringTag === '[object String]') {
+        return false;
+    }
+    return true;
+}
+// Helper to safely set a property on an object or array
+function setProperty(obj, key, value) {
+    if (Array.isArray(obj) && typeof key === 'number') {
+        obj[key] = value;
+    }
+    else if (!Array.isArray(obj) && typeof key === 'string') {
+        obj[key] = value;
+    }
+    else if (!Array.isArray(obj) && typeof key === 'number') {
+        // Handle numeric keys on objects
+        obj[key] = value;
+    }
+}
+// Helper to safely delete a property from an object
+function deleteProperty(obj, key) {
+    if (Array.isArray(obj) && typeof key === 'number') {
+        // For arrays, we should use splice, but this is handled in remove()
+        // This function is only called for non-array deletion
+        return;
+    }
+    if (!Array.isArray(obj)) {
+        delete obj[key];
+    }
+}
+function forEach(obj, callback) {
+    const visited = new WeakSet();
+    function walk(node, path = [], parent) {
+        // Check for circular references
+        let circular = null;
+        if (isObject(node)) {
+            if (visited.has(node)) {
+                // Find the circular reference in the parent chain
+                let p = parent;
+                while (p) {
+                    if (p.node === node) {
+                        circular = p;
+                        break;
+                    }
+                    p = p.parent;
+                }
+                return; // Skip circular references
+            }
+            visited.add(node);
+        }
+        const key = path.length > 0 ? path[path.length - 1] : undefined;
+        const isRoot = path.length === 0;
+        const level = path.length;
+        // Determine if this is a leaf node
+        const isLeaf = !isObject(node) ||
+            (Array.isArray(node) && node.length === 0) ||
+            Object.keys(node).length === 0;
+        // Create context
+        const context = {
+            node,
+            path: [...path],
+            parent,
+            key,
+            isLeaf,
+            notLeaf: !isLeaf,
+            isRoot,
+            notRoot: !isRoot,
+            level,
+            circular,
+            update(value) {
+                if (!isRoot && parent && key !== undefined && isObject(parent.node)) {
+                    setProperty(parent.node, key, value);
+                }
+                this.node = value;
+            },
+            remove() {
+                if (!isRoot && parent && key !== undefined && isObject(parent.node)) {
+                    if (Array.isArray(parent.node) && typeof key === 'number') {
+                        parent.node.splice(key, 1);
+                    }
+                    else {
+                        deleteProperty(parent.node, key);
+                    }
+                }
+            },
+        };
+        // Call the callback with the context
+        callback.call(context, node);
+        // Traverse children if not circular and is an object
+        if (!circular && isObject(node) && !isLeaf) {
+            if (Array.isArray(node)) {
+                for (let i = 0; i < node.length; i++) {
+                    walk(node[i], [...path, i], context);
+                }
+            }
+            else {
+                for (const [childKey, childValue] of Object.entries(node)) {
+                    walk(childValue, [...path, childKey], context);
+                }
+            }
+        }
+    }
+    walk(obj);
+}
+// Main traverse function that returns an object with forEach method
+function traverse(obj) {
+    return {
+        forEach(callback) {
+            forEach(obj, callback);
         },
-        privacy_policy_url: String,
-        raw_spec: String,
-        oauth_client_id: String,
-        oauth_client_secret: String,
-    },
-});
+    };
+}
 
-const agentSchema = new Schema({
-    id: {
-        type: String,
-        index: true,
-        unique: true,
-        required: true,
-    },
-    name: {
-        type: String,
-    },
-    description: {
-        type: String,
-    },
-    instructions: {
-        type: String,
-    },
-    avatar: {
-        type: Schema.Types.Mixed,
-        default: undefined,
-    },
-    provider: {
-        type: String,
-        required: true,
-    },
-    model: {
-        type: String,
-        required: true,
-    },
-    model_parameters: {
-        type: Object,
-    },
-    artifacts: {
-        type: String,
-    },
-    access_level: {
-        type: Number,
-    },
-    recursion_limit: {
-        type: Number,
-    },
-    tools: {
-        type: [String],
-        default: undefined,
-    },
-    tool_kwargs: {
-        type: [{ type: Schema.Types.Mixed }],
-    },
-    actions: {
-        type: [String],
-        default: undefined,
-    },
-    author: {
-        type: Schema.Types.ObjectId,
-        ref: 'User',
-        required: true,
-    },
-    authorName: {
-        type: String,
-        default: undefined,
-    },
-    hide_sequential_outputs: {
-        type: Boolean,
-    },
-    end_after_tools: {
-        type: Boolean,
-    },
-    agent_ids: {
-        type: [String],
-    },
-    isCollaborative: {
-        type: Boolean,
-        default: undefined,
-    },
-    conversation_starters: {
-        type: [String],
-        default: [],
-    },
-    tool_resources: {
-        type: Schema.Types.Mixed,
-        default: {},
-    },
-    projectIds: {
-        type: [Schema.Types.ObjectId],
-        ref: 'Project',
-        index: true,
-    },
-    versions: {
-        type: [Schema.Types.Mixed],
-        default: [],
-    },
-    category: {
-        type: String,
-        trim: true,
-        index: true,
-        default: 'general',
-    },
-    support_contact: {
-        type: Schema.Types.Mixed,
-        default: undefined,
-    },
-    is_promoted: {
-        type: Boolean,
-        default: false,
-        index: true,
-    },
-}, {
-    timestamps: true,
+const SPLAT_SYMBOL = Symbol.for('splat');
+const MESSAGE_SYMBOL = Symbol.for('message');
+const CONSOLE_JSON_STRING_LENGTH = parseInt(process.env.CONSOLE_JSON_STRING_LENGTH || '', 10) || 255;
+const DEBUG_MESSAGE_LENGTH = parseInt(process.env.DEBUG_MESSAGE_LENGTH || '', 10) || 150;
+const sensitiveKeys = [
+    /^(sk-)[^\s]+/, // OpenAI API key pattern
+    /(Bearer )[^\s]+/, // Header: Bearer token pattern
+    /(api-key:? )[^\s]+/, // Header: API key pattern
+    /(key=)[^\s]+/, // URL query param: sensitive key pattern (Google)
+];
+/**
+ * Determines if a given value string is sensitive and returns matching regex patterns.
+ *
+ * @param valueStr - The value string to check.
+ * @returns An array of regex patterns that match the value string.
+ */
+function getMatchingSensitivePatterns(valueStr) {
+    if (valueStr) {
+        // Filter and return all regex patterns that match the value string
+        return sensitiveKeys.filter((regex) => regex.test(valueStr));
+    }
+    return [];
+}
+/**
+ * Redacts sensitive information from a console message and trims it to a specified length if provided.
+ * @param str - The console message to be redacted.
+ * @param trimLength - The optional length at which to trim the redacted message.
+ * @returns The redacted and optionally trimmed console message.
+ */
+function redactMessage(str, trimLength) {
+    if (!str) {
+        return '';
+    }
+    const patterns = getMatchingSensitivePatterns(str);
+    patterns.forEach((pattern) => {
+        str = str.replace(pattern, '$1[REDACTED]');
+    });
+    return str;
+}
+/**
+ * Redacts sensitive information from log messages if the log level is 'error'.
+ * Note: Intentionally mutates the object.
+ * @param info - The log information object.
+ * @returns The modified log information object.
+ */
+const redactFormat = winston.format((info) => {
+    if (info.level === 'error') {
+        // Type guard to ensure message is a string
+        if (typeof info.message === 'string') {
+            info.message = redactMessage(info.message);
+        }
+        // Handle MESSAGE_SYMBOL with type safety
+        const symbolValue = info[MESSAGE_SYMBOL];
+        if (typeof symbolValue === 'string') {
+            info[MESSAGE_SYMBOL] = redactMessage(symbolValue);
+        }
+    }
+    return info;
 });
-agentSchema.index({ updatedAt: -1, _id: 1 });
-
-const agentCategorySchema = new Schema({
-    value: {
-        type: String,
-        required: true,
-        unique: true,
-        trim: true,
-        lowercase: true,
-        index: true,
-    },
-    label: {
-        type: String,
-        required: true,
-        trim: true,
-    },
-    description: {
-        type: String,
-        trim: true,
-        default: '',
-    },
-    order: {
-        type: Number,
-        default: 0,
-        index: true,
-    },
-    isActive: {
-        type: Boolean,
-        default: true,
-        index: true,
-    },
-    custom: {
-        type: Boolean,
-        default: false,
-    },
-}, {
-    timestamps: true,
+/**
+ * Truncates long strings, especially base64 image data, within log messages.
+ *
+ * @param value - The value to be inspected and potentially truncated.
+ * @param length - The length at which to truncate the value. Default: 100.
+ * @returns The truncated or original value.
+ */
+const truncateLongStrings = (value, length = 100) => {
+    if (typeof value === 'string') {
+        return value.length > length ? value.substring(0, length) + '... [truncated]' : value;
+    }
+    return value;
+};
+/**
+ * An array mapping function that truncates long strings (objects converted to JSON strings).
+ * @param item - The item to be condensed.
+ * @returns The condensed item.
+ */
+const condenseArray = (item) => {
+    if (typeof item === 'string') {
+        return truncateLongStrings(JSON.stringify(item));
+    }
+    else if (typeof item === 'object') {
+        return truncateLongStrings(JSON.stringify(item));
+    }
+    return item;
+};
+/**
+ * Formats log messages for debugging purposes.
+ * - Truncates long strings within log messages.
+ * - Condenses arrays by truncating long strings and objects as strings within array items.
+ * - Redacts sensitive information from log messages if the log level is 'error'.
+ * - Converts log information object to a formatted string.
+ *
+ * @param options - The options for formatting log messages.
+ * @returns The formatted log message.
+ */
+const debugTraverse = winston.format.printf(({ level, message, timestamp, ...metadata }) => {
+    if (!message) {
+        return `${timestamp} ${level}`;
+    }
+    // Type-safe version of the CJS logic: !message?.trim || typeof message !== 'string'
+    if (typeof message !== 'string' || !message.trim) {
+        return `${timestamp} ${level}: ${JSON.stringify(message)}`;
+    }
+    const msgParts = [
+        `${timestamp} ${level}: ${truncateLongStrings(message.trim(), DEBUG_MESSAGE_LENGTH)}`,
+    ];
+    try {
+        if (level !== 'debug') {
+            return msgParts[0];
+        }
+        if (!metadata) {
+            return msgParts[0];
+        }
+        // Type-safe access to SPLAT_SYMBOL using bracket notation
+        const metadataRecord = metadata;
+        const splatArray = metadataRecord[SPLAT_SYMBOL];
+        const debugValue = Array.isArray(splatArray) ? splatArray[0] : undefined;
+        if (!debugValue) {
+            return msgParts[0];
+        }
+        if (debugValue && Array.isArray(debugValue)) {
+            msgParts.push(`\n${JSON.stringify(debugValue.map(condenseArray))}`);
+            return msgParts.join('');
+        }
+        if (typeof debugValue !== 'object') {
+            msgParts.push(` ${debugValue}`);
+            return msgParts.join('');
+        }
+        msgParts.push('\n{');
+        const copy = klona(metadata);
+        try {
+            const traversal = traverse(copy);
+            traversal.forEach(function (value) {
+                var _a;
+                if (typeof (this === null || this === void 0 ? void 0 : this.key) === 'symbol') {
+                    return;
+                }
+                let _parentKey = '';
+                const parent = this.parent;
+                if (typeof (parent === null || parent === void 0 ? void 0 : parent.key) !== 'symbol' && (parent === null || parent === void 0 ? void 0 : parent.key) !== undefined) {
+                    _parentKey = String(parent.key);
+                }
+                const parentKey = `${parent && parent.notRoot ? _parentKey + '.' : ''}`;
+                const tabs = `${parent && parent.notRoot ? '    ' : '  '}`;
+                const currentKey = (_a = this === null || this === void 0 ? void 0 : this.key) !== null && _a !== void 0 ? _a : 'unknown';
+                if (this.isLeaf && typeof value === 'string') {
+                    const truncatedText = truncateLongStrings(value);
+                    msgParts.push(`\n${tabs}${parentKey}${currentKey}: ${JSON.stringify(truncatedText)},`);
+                }
+                else if (this.notLeaf && Array.isArray(value) && value.length > 0) {
+                    const currentMessage = `\n${tabs}// ${value.length} ${String(currentKey).replace(/s$/, '')}(s)`;
+                    this.update(currentMessage);
+                    msgParts.push(currentMessage);
+                    const stringifiedArray = value.map(condenseArray);
+                    msgParts.push(`\n${tabs}${parentKey}${currentKey}: [${stringifiedArray}],`);
+                }
+                else if (this.isLeaf && typeof value === 'function') {
+                    msgParts.push(`\n${tabs}${parentKey}${currentKey}: function,`);
+                }
+                else if (this.isLeaf) {
+                    msgParts.push(`\n${tabs}${parentKey}${currentKey}: ${value},`);
+                }
+            });
+        }
+        catch (e) {
+            const errorMessage = e instanceof Error ? e.message : 'Unknown error';
+            msgParts.push(`\n[LOGGER TRAVERSAL ERROR] ${errorMessage}`);
+        }
+        msgParts.push('\n}');
+        return msgParts.join('');
+    }
+    catch (e) {
+        const errorMessage = e instanceof Error ? e.message : 'Unknown error';
+        msgParts.push(`\n[LOGGER PARSING ERROR] ${errorMessage}`);
+        return msgParts.join('');
+    }
+});
+/**
+ * Truncates long string values in JSON log objects.
+ * Prevents outputting extremely long values (e.g., base64, blobs).
+ */
+const jsonTruncateFormat = winston.format((info) => {
+    const truncateLongStrings = (str, maxLength) => str.length > maxLength ? str.substring(0, maxLength) + '...' : str;
+    const seen = new WeakSet();
+    const truncateObject = (obj) => {
+        if (typeof obj !== 'object' || obj === null) {
+            return obj;
+        }
+        // Handle circular references - now with proper object type
+        if (seen.has(obj)) {
+            return '[Circular]';
+        }
+        seen.add(obj);
+        if (Array.isArray(obj)) {
+            return obj.map((item) => truncateObject(item));
+        }
+        // We know this is an object at this point
+        const objectRecord = obj;
+        const newObj = {};
+        Object.entries(objectRecord).forEach(([key, value]) => {
+            if (typeof value === 'string') {
+                newObj[key] = truncateLongStrings(value, CONSOLE_JSON_STRING_LENGTH);
+            }
+            else {
+                newObj[key] = truncateObject(value);
+            }
+        });
+        return newObj;
+    };
+    return truncateObject(info);
 });
-agentCategorySchema.index({ isActive: 1, order: 1 });
-agentCategorySchema.index({ order: 1, label: 1 });
 
-const assistantSchema = new Schema({
-    user: {
-        type: Schema.Types.ObjectId,
-        ref: 'User',
-        required: true,
-    },
-    assistant_id: {
-        type: String,
-        index: true,
-        required: true,
-    },
-    avatar: {
-        type: Schema.Types.Mixed,
-        default: undefined,
-    },
-    conversation_starters: {
-        type: [String],
-        default: [],
-    },
-    access_level: {
-        type: Number,
-    },
-    file_ids: { type: [String], default: undefined },
-    actions: { type: [String], default: undefined },
-    append_current_datetime: {
-        type: Boolean,
-        default: false,
-    },
-}, {
-    timestamps: true,
+/**
+ * Determine the log directory in a cross-compatible way.
+ * Priority:
+ * 1. LIBRECHAT_LOG_DIR environment variable
+ * 2. If running within LibreChat monorepo (when cwd ends with /api), use api/logs
+ * 3. If api/logs exists relative to cwd, use that (for running from project root)
+ * 4. Otherwise, use logs directory relative to process.cwd()
+ *
+ * This avoids using __dirname which is not available in ESM modules
+ */
+const getLogDirectory = () => {
+    if (process.env.LIBRECHAT_LOG_DIR) {
+        return process.env.LIBRECHAT_LOG_DIR;
+    }
+    const cwd = process.cwd();
+    // Check if we're running from within the api directory
+    if (cwd.endsWith('/api') || cwd.endsWith('\\api')) {
+        return path.join(cwd, 'logs');
+    }
+    // Check if api/logs exists relative to current directory (running from project root)
+    // We'll just use the path and let the file system create it if needed
+    const apiLogsPath = path.join(cwd, 'api', 'logs');
+    // For LibreChat project structure, use api/logs
+    // For external consumers, they should set LIBRECHAT_LOG_DIR
+    if (cwd.includes('LibreChat')) {
+        return apiLogsPath;
+    }
+    // Default to logs directory relative to current working directory
+    return path.join(cwd, 'logs');
+};
+
+const logDir$1 = getLogDirectory();
+const { NODE_ENV: NODE_ENV$1, DEBUG_LOGGING: DEBUG_LOGGING$1, CONSOLE_JSON, DEBUG_CONSOLE } = process.env;
+const useConsoleJson = typeof CONSOLE_JSON === 'string' && CONSOLE_JSON.toLowerCase() === 'true';
+const useDebugConsole = typeof DEBUG_CONSOLE === 'string' && DEBUG_CONSOLE.toLowerCase() === 'true';
+const useDebugLogging$1 = typeof DEBUG_LOGGING$1 === 'string' && DEBUG_LOGGING$1.toLowerCase() === 'true';
+const levels$1 = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    http: 3,
+    verbose: 4,
+    debug: 5,
+    activity: 6,
+    silly: 7,
+};
+winston.addColors({
+    info: 'green',
+    warn: 'italic yellow',
+    error: 'red',
+    debug: 'blue',
+});
+const level$1 = () => {
+    const env = NODE_ENV$1 || 'development';
+    return env === 'development' ? 'debug' : 'warn';
+};
+const fileFormat$1 = winston.format.combine(redactFormat(), winston.format.timestamp({ format: () => new Date().toISOString() }), winston.format.errors({ stack: true }), winston.format.splat());
+const transports$1 = [
+    new winston.transports.DailyRotateFile({
+        level: 'error',
+        filename: `${logDir$1}/error-%DATE%.log`,
+        datePattern: 'YYYY-MM-DD',
+        zippedArchive: true,
+        maxSize: '20m',
+        maxFiles: '14d',
+        format: winston.format.combine(fileFormat$1, winston.format.json()),
+    }),
+];
+if (useDebugLogging$1) {
+    transports$1.push(new winston.transports.DailyRotateFile({
+        level: 'debug',
+        filename: `${logDir$1}/debug-%DATE%.log`,
+        datePattern: 'YYYY-MM-DD',
+        zippedArchive: true,
+        maxSize: '20m',
+        maxFiles: '14d',
+        format: winston.format.combine(fileFormat$1, debugTraverse),
+    }));
+}
+const consoleFormat$1 = winston.format.combine(redactFormat(), winston.format.colorize({ all: true }), winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.printf((info) => {
+    const message = `${info.timestamp} ${info.level}: ${info.message}`;
+    return info.level.includes('error') ? redactMessage(message) : message;
+}));
+let consoleLogLevel = 'info';
+if (useDebugConsole) {
+    consoleLogLevel = 'debug';
+}
+// Add console transport
+if (useDebugConsole) {
+    transports$1.push(new winston.transports.Console({
+        level: consoleLogLevel,
+        format: useConsoleJson
+            ? winston.format.combine(fileFormat$1, jsonTruncateFormat(), winston.format.json())
+            : winston.format.combine(fileFormat$1, debugTraverse),
+    }));
+}
+else if (useConsoleJson) {
+    transports$1.push(new winston.transports.Console({
+        level: consoleLogLevel,
+        format: winston.format.combine(fileFormat$1, jsonTruncateFormat(), winston.format.json()),
+    }));
+}
+else {
+    transports$1.push(new winston.transports.Console({
+        level: consoleLogLevel,
+        format: consoleFormat$1,
+    }));
+}
+// Create logger
+const logger$1 = winston.createLogger({
+    level: level$1(),
+    levels: levels$1,
+    transports: transports$1,
 });
 
-const balanceSchema = new Schema({
-    user: {
-        type: Schema.Types.ObjectId,
-        ref: 'User',
-        index: true,
-        required: true,
-    },
-    // 1000 tokenCredits = 1 mill ($0.001 USD)
-    tokenCredits: {
-        type: Number,
-        default: 0,
-    },
-    // Automatic refill settings
-    autoRefillEnabled: {
-        type: Boolean,
-        default: false,
-    },
-    refillIntervalValue: {
-        type: Number,
-        default: 30,
-    },
-    refillIntervalUnit: {
-        type: String,
-        enum: ['seconds', 'minutes', 'hours', 'days', 'weeks', 'months'],
-        default: 'days',
-    },
-    lastRefill: {
-        type: Date,
-        default: Date.now,
-    },
-    // amount to add on each refill
-    refillAmount: {
-        type: Number,
-        default: 0,
-    },
-});
+/**
+ * Loads and maps the Cloudflare Turnstile configuration.
+ *
+ * Expected config structure:
+ *
+ * turnstile:
+ *   siteKey: "your-site-key-here"
+ *   options:
+ *     language: "auto"    // "auto" or an ISO 639-1 language code (e.g. en)
+ *     size: "normal"      // Options: "normal", "compact", "flexible", or "invisible"
+ *
+ * @param config - The loaded custom configuration.
+ * @param configDefaults - The custom configuration default values.
+ * @returns The mapped Turnstile configuration.
+ */
+function loadTurnstileConfig(config, configDefaults) {
+    var _a, _b;
+    const { turnstile: customTurnstile } = config !== null && config !== void 0 ? config : {};
+    const { turnstile: defaults } = configDefaults;
+    const loadedTurnstile = removeNullishValues({
+        siteKey: (_a = customTurnstile === null || customTurnstile === void 0 ? void 0 : customTurnstile.siteKey) !== null && _a !== void 0 ? _a : defaults === null || defaults === void 0 ? void 0 : defaults.siteKey,
+        options: (_b = customTurnstile === null || customTurnstile === void 0 ? void 0 : customTurnstile.options) !== null && _b !== void 0 ? _b : defaults === null || defaults === void 0 ? void 0 : defaults.options,
+    });
+    const enabled = Boolean(loadedTurnstile.siteKey);
+    if (enabled) {
+        logger$1.debug('Turnstile is ENABLED with configuration:\n' + JSON.stringify(loadedTurnstile, null, 2));
+    }
+    else {
+        logger$1.debug('Turnstile is DISABLED (no siteKey provided).');
+    }
+    return loadedTurnstile;
+}
 
-const bannerSchema = new Schema({
-    bannerId: {
-        type: String,
-        required: true,
-    },
-    message: {
-        type: String,
-        required: true,
-    },
-    displayFrom: {
-        type: Date,
-        required: true,
-        default: Date.now,
-    },
-    displayTo: {
-        type: Date,
+const webSearchAuth = {
+    providers: {
+        serper: {
+            serperApiKey: 1,
+        },
+        searxng: {
+            searxngInstanceUrl: 1,
+            /** Optional (0) */
+            searxngApiKey: 0,
+        },
     },
-    type: {
-        type: String,
-        enum: ['banner', 'popup'],
-        default: 'banner',
+    scrapers: {
+        firecrawl: {
+            firecrawlApiKey: 1,
+            /** Optional (0) */
+            firecrawlApiUrl: 0,
+            firecrawlVersion: 0,
+        },
+        serper: {
+            serperApiKey: 1,
+        },
     },
-    isPublic: {
-        type: Boolean,
-        default: false,
+    rerankers: {
+        jina: {
+            jinaApiKey: 1,
+            /** Optional (0) */
+            jinaApiUrl: 0,
+        },
+        cohere: { cohereApiKey: 1 },
     },
-}, { timestamps: true });
+};
+/**
+ * Extracts all unique API keys from the webSearchAuth configuration object
+ */
+function getWebSearchKeys() {
+    const keysSet = new Set();
+    // Iterate through each category (providers, scrapers, rerankers)
+    for (const category of Object.keys(webSearchAuth)) {
+        const categoryObj = webSearchAuth[category];
+        // Iterate through each service within the category
+        for (const service of Object.keys(categoryObj)) {
+            const serviceObj = categoryObj[service];
+            // Extract the API keys from the service and add to set for deduplication
+            for (const key of Object.keys(serviceObj)) {
+                keysSet.add(key);
+            }
+        }
+    }
+    return Array.from(keysSet);
+}
+const webSearchKeys = getWebSearchKeys();
+function loadWebSearchConfig(config) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const serperApiKey = (_a = config === null || config === void 0 ? void 0 : config.serperApiKey) !== null && _a !== void 0 ? _a : '${SERPER_API_KEY}';
+    const searxngInstanceUrl = (_b = config === null || config === void 0 ? void 0 : config.searxngInstanceUrl) !== null && _b !== void 0 ? _b : '${SEARXNG_INSTANCE_URL}';
+    const searxngApiKey = (_c = config === null || config === void 0 ? void 0 : config.searxngApiKey) !== null && _c !== void 0 ? _c : '${SEARXNG_API_KEY}';
+    const firecrawlApiKey = (_d = config === null || config === void 0 ? void 0 : config.firecrawlApiKey) !== null && _d !== void 0 ? _d : '${FIRECRAWL_API_KEY}';
+    const firecrawlApiUrl = (_e = config === null || config === void 0 ? void 0 : config.firecrawlApiUrl) !== null && _e !== void 0 ? _e : '${FIRECRAWL_API_URL}';
+    const firecrawlVersion = (_f = config === null || config === void 0 ? void 0 : config.firecrawlVersion) !== null && _f !== void 0 ? _f : '${FIRECRAWL_VERSION}';
+    const jinaApiKey = (_g = config === null || config === void 0 ? void 0 : config.jinaApiKey) !== null && _g !== void 0 ? _g : '${JINA_API_KEY}';
+    const jinaApiUrl = (_h = config === null || config === void 0 ? void 0 : config.jinaApiUrl) !== null && _h !== void 0 ? _h : '${JINA_API_URL}';
+    const cohereApiKey = (_j = config === null || config === void 0 ? void 0 : config.cohereApiKey) !== null && _j !== void 0 ? _j : '${COHERE_API_KEY}';
+    const safeSearch = (_k = config === null || config === void 0 ? void 0 : config.safeSearch) !== null && _k !== void 0 ? _k : SafeSearchTypes.MODERATE;
+    return {
+        ...config,
+        safeSearch,
+        jinaApiKey,
+        jinaApiUrl,
+        cohereApiKey,
+        serperApiKey,
+        searxngApiKey,
+        firecrawlApiKey,
+        firecrawlApiUrl,
+        firecrawlVersion,
+        searxngInstanceUrl,
+    };
+}
 
-const categoriesSchema = new Schema({
-    label: {
-        type: String,
-        required: true,
-        unique: true,
-    },
-    value: {
-        type: String,
-        required: true,
-        unique: true,
-    },
-});
+/**
+ * Sets up Model Specs from the config (`librechat.yaml`) file.
+ * @param [endpoints] - The loaded custom configuration for endpoints.
+ * @param [modelSpecs] - The loaded custom configuration for model specs.
+ * @param [interfaceConfig] - The loaded interface configuration.
+ * @returns The processed model specs, if any.
+ */
+function processModelSpecs(endpoints, _modelSpecs, interfaceConfig) {
+    var _a, _b, _c, _d;
+    if (!_modelSpecs) {
+        return undefined;
+    }
+    const list = _modelSpecs.list;
+    const modelSpecs = [];
+    const customEndpoints = (_a = endpoints === null || endpoints === void 0 ? void 0 : endpoints[EModelEndpoint.custom]) !== null && _a !== void 0 ? _a : [];
+    if ((interfaceConfig === null || interfaceConfig === void 0 ? void 0 : interfaceConfig.modelSelect) !== true && ((_c = (_b = _modelSpecs.addedEndpoints) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) > 0) {
+        logger$1.warn(`To utilize \`addedEndpoints\`, which allows provider/model selections alongside model specs, set \`modelSelect: true\` in the interface configuration.
 
-const conversationTag = new Schema({
-    tag: {
-        type: String,
-        index: true,
-    },
-    user: {
-        type: String,
-        index: true,
-    },
-    description: {
-        type: String,
-        index: true,
-    },
-    count: {
-        type: Number,
-        default: 0,
-    },
-    position: {
-        type: Number,
-        default: 0,
-        index: true,
-    },
-}, { timestamps: true });
-// Create a compound index on tag and user with unique constraint.
-conversationTag.index({ tag: 1, user: 1 }, { unique: true });
+      Example:
+      \`\`\`yaml
+      interface:
+        modelSelect: true
+      \`\`\`
+      `);
+    }
+    if (!list || list.length === 0) {
+        return undefined;
+    }
+    for (const spec of list) {
+        const currentEndpoint = (_d = spec.preset) === null || _d === void 0 ? void 0 : _d.endpoint;
+        if (!currentEndpoint) {
+            logger$1.warn('A model spec is missing the `endpoint` field within its `preset`. Skipping model spec...');
+            continue;
+        }
+        if (EModelEndpoint[currentEndpoint] && currentEndpoint !== EModelEndpoint.custom) {
+            modelSpecs.push(spec);
+            continue;
+        }
+        else if (currentEndpoint === EModelEndpoint.custom) {
+            logger$1.warn(`Model Spec with endpoint "${currentEndpoint}" is not supported. You must specify the name of the custom endpoint (case-sensitive, as defined in your config). Skipping model spec...`);
+            continue;
+        }
+        const normalizedName = normalizeEndpointName(currentEndpoint);
+        const endpoint = customEndpoints.find((customEndpoint) => normalizedName === normalizeEndpointName(customEndpoint.name));
+        if (!endpoint) {
+            logger$1.warn(`Model spec with endpoint "${currentEndpoint}" was skipped: Endpoint not found in configuration. The \`endpoint\` value must exactly match either a system-defined endpoint or a custom endpoint defined by the user.
 
-// @ts-ignore
-const conversationPreset = {
-    // endpoint: [azureOpenAI, openAI, anthropic, chatGPTBrowser]
-    endpoint: {
-        type: String,
-        default: null,
+For more information, see the documentation at https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/model_specs#endpoint`);
+            continue;
+        }
+        modelSpecs.push({
+            ...spec,
+            preset: {
+                ...spec.preset,
+                endpoint: normalizedName,
+            },
+        });
+    }
+    return {
+        ..._modelSpecs,
+        list: modelSpecs,
+    };
+}
+
+/**
+ * Sets up the minimum, default Assistants configuration if Azure OpenAI Assistants option is enabled.
+ * @returns The Assistants endpoint configuration.
+ */
+function azureAssistantsDefaults() {
+    return {
+        capabilities: [Capabilities.tools, Capabilities.actions, Capabilities.code_interpreter],
+        version: defaultAssistantsVersion.azureAssistants,
+    };
+}
+/**
+ * Sets up the Assistants configuration from the config (`librechat.yaml`) file.
+ * @param config - The loaded custom configuration.
+ * @param assistantsEndpoint - The Assistants endpoint name.
+ * - The previously loaded assistants configuration from Azure OpenAI Assistants option.
+ * @param [prevConfig]
+ * @returns The Assistants endpoint configuration.
+ */
+function assistantsConfigSetup(config, assistantsEndpoint, prevConfig = {}) {
+    var _a, _b, _c, _d, _e;
+    const assistantsConfig = (_a = config.endpoints) === null || _a === void 0 ? void 0 : _a[assistantsEndpoint];
+    const parsedConfig = assistantEndpointSchema.parse(assistantsConfig);
+    if (((_b = assistantsConfig === null || assistantsConfig === void 0 ? void 0 : assistantsConfig.supportedIds) === null || _b === void 0 ? void 0 : _b.length) && ((_c = assistantsConfig.excludedIds) === null || _c === void 0 ? void 0 : _c.length)) {
+        logger$1.warn(`Configuration conflict: The '${assistantsEndpoint}' endpoint has both 'supportedIds' and 'excludedIds' defined. The 'excludedIds' will be ignored.`);
+    }
+    if ((assistantsConfig === null || assistantsConfig === void 0 ? void 0 : assistantsConfig.privateAssistants) &&
+        (((_d = assistantsConfig.supportedIds) === null || _d === void 0 ? void 0 : _d.length) || ((_e = assistantsConfig.excludedIds) === null || _e === void 0 ? void 0 : _e.length))) {
+        logger$1.warn(`Configuration conflict: The '${assistantsEndpoint}' endpoint has both 'privateAssistants' and 'supportedIds' or 'excludedIds' defined. The 'supportedIds' and 'excludedIds' will be ignored.`);
+    }
+    return {
+        ...prevConfig,
+        retrievalModels: parsedConfig.retrievalModels,
+        disableBuilder: parsedConfig.disableBuilder,
+        pollIntervalMs: parsedConfig.pollIntervalMs,
+        supportedIds: parsedConfig.supportedIds,
+        capabilities: parsedConfig.capabilities,
+        excludedIds: parsedConfig.excludedIds,
+        privateAssistants: parsedConfig.privateAssistants,
+        timeoutMs: parsedConfig.timeoutMs,
+        streamRate: parsedConfig.streamRate,
+        titlePrompt: parsedConfig.titlePrompt,
+        titleMethod: parsedConfig.titleMethod,
+        titleModel: parsedConfig.titleModel,
+        titleEndpoint: parsedConfig.titleEndpoint,
+        titlePromptTemplate: parsedConfig.titlePromptTemplate,
+    };
+}
+
+/**
+ * Sets up the Azure OpenAI configuration from the config (`librechat.yaml`) file.
+ * @param config - The loaded custom configuration.
+ * @returns The Azure OpenAI configuration.
+ */
+function azureConfigSetup(config) {
+    var _a, _b, _c;
+    const azureConfig = (_a = config.endpoints) === null || _a === void 0 ? void 0 : _a[EModelEndpoint.azureOpenAI];
+    if (!azureConfig) {
+        throw new Error('Azure OpenAI configuration is missing.');
+    }
+    const { groups, ...azureConfiguration } = azureConfig;
+    const { isValid, modelNames, modelGroupMap, groupMap, errors } = validateAzureGroups(groups);
+    if (!isValid) {
+        const errorString = errors.join('\n');
+        const errorMessage = 'Invalid Azure OpenAI configuration:\n' + errorString;
+        logger$1.error(errorMessage);
+        throw new Error(errorMessage);
+    }
+    const assistantModels = [];
+    const assistantGroups = new Set();
+    for (const modelName of modelNames) {
+        mapModelToAzureConfig({ modelName, modelGroupMap, groupMap });
+        const groupName = (_b = modelGroupMap === null || modelGroupMap === void 0 ? void 0 : modelGroupMap[modelName]) === null || _b === void 0 ? void 0 : _b.group;
+        const modelGroup = groupMap === null || groupMap === void 0 ? void 0 : groupMap[groupName];
+        const supportsAssistants = (modelGroup === null || modelGroup === void 0 ? void 0 : modelGroup.assistants) || ((_c = modelGroup === null || modelGroup === void 0 ? void 0 : modelGroup[modelName]) === null || _c === void 0 ? void 0 : _c.assistants);
+        if (supportsAssistants) {
+            assistantModels.push(modelName);
+            if (!assistantGroups.has(groupName)) {
+                assistantGroups.add(groupName);
+            }
+        }
+    }
+    if (azureConfiguration.assistants && assistantModels.length === 0) {
+        throw new Error('No Azure models are configured to support assistants. Please remove the `assistants` field or configure at least one model to support assistants.');
+    }
+    if (azureConfiguration.assistants &&
+        process.env.ENDPOINTS &&
+        !process.env.ENDPOINTS.includes(EModelEndpoint.azureAssistants)) {
+        logger$1.warn(`Azure Assistants are configured, but the endpoint will not be accessible as it's not included in the ENDPOINTS environment variable.
+      Please add the value "${EModelEndpoint.azureAssistants}" to the ENDPOINTS list if expected.`);
+    }
+    return {
+        errors,
+        isValid,
+        groupMap,
+        modelNames,
+        modelGroupMap,
+        assistantModels,
+        assistantGroups: Array.from(assistantGroups),
+        ...azureConfiguration,
+    };
+}
+
+/**
+ * Loads custom config endpoints
+ * @param [config]
+ * @param [agentsDefaults]
+ */
+const loadEndpoints = (config, agentsDefaults) => {
+    var _a;
+    const loadedEndpoints = {};
+    const endpoints = config === null || config === void 0 ? void 0 : config.endpoints;
+    if (endpoints === null || endpoints === void 0 ? void 0 : endpoints[EModelEndpoint.azureOpenAI]) {
+        loadedEndpoints[EModelEndpoint.azureOpenAI] = azureConfigSetup(config);
+    }
+    if ((_a = endpoints === null || endpoints === void 0 ? void 0 : endpoints[EModelEndpoint.azureOpenAI]) === null || _a === void 0 ? void 0 : _a.assistants) {
+        loadedEndpoints[EModelEndpoint.azureAssistants] = azureAssistantsDefaults();
+    }
+    if (endpoints === null || endpoints === void 0 ? void 0 : endpoints[EModelEndpoint.azureAssistants]) {
+        loadedEndpoints[EModelEndpoint.azureAssistants] = assistantsConfigSetup(config, EModelEndpoint.azureAssistants, loadedEndpoints[EModelEndpoint.azureAssistants]);
+    }
+    if (endpoints === null || endpoints === void 0 ? void 0 : endpoints[EModelEndpoint.assistants]) {
+        loadedEndpoints[EModelEndpoint.assistants] = assistantsConfigSetup(config, EModelEndpoint.assistants, loadedEndpoints[EModelEndpoint.assistants]);
+    }
+    loadedEndpoints[EModelEndpoint.agents] = agentsConfigSetup(config, agentsDefaults);
+    const endpointKeys = [
+        EModelEndpoint.openAI,
+        EModelEndpoint.google,
+        EModelEndpoint.custom,
+        EModelEndpoint.bedrock,
+        EModelEndpoint.anthropic,
+    ];
+    endpointKeys.forEach((key) => {
+        const currentKey = key;
+        if (endpoints === null || endpoints === void 0 ? void 0 : endpoints[currentKey]) {
+            loadedEndpoints[currentKey] = endpoints[currentKey];
+        }
+    });
+    if (endpoints === null || endpoints === void 0 ? void 0 : endpoints.all) {
+        loadedEndpoints.all = endpoints.all;
+    }
+    return loadedEndpoints;
+};
+
+function loadOCRConfig(config) {
+    var _a, _b, _c, _d;
+    if (!config)
+        return;
+    const baseURL = (_a = config === null || config === void 0 ? void 0 : config.baseURL) !== null && _a !== void 0 ? _a : '';
+    const apiKey = (_b = config === null || config === void 0 ? void 0 : config.apiKey) !== null && _b !== void 0 ? _b : '';
+    const mistralModel = (_c = config === null || config === void 0 ? void 0 : config.mistralModel) !== null && _c !== void 0 ? _c : '';
+    return {
+        apiKey,
+        baseURL,
+        mistralModel,
+        strategy: (_d = config === null || config === void 0 ? void 0 : config.strategy) !== null && _d !== void 0 ? _d : OCRStrategy.MISTRAL_OCR,
+    };
+}
+
+/**
+ * Loads custom config and initializes app-wide variables.
+ * @function AppService
+ */
+const AppService = async (params) => {
+    var _a, _b, _c, _d, _e, _f;
+    const { config, paths, systemTools } = params || {};
+    if (!config) {
+        throw new Error('Config is required');
+    }
+    const configDefaults = getConfigDefaults();
+    const ocr = loadOCRConfig(config.ocr);
+    const webSearch = loadWebSearchConfig(config.webSearch);
+    const memory = loadMemoryConfig(config.memory);
+    const filteredTools = config.filteredTools;
+    const includedTools = config.includedTools;
+    const fileStrategy = ((_a = config.fileStrategy) !== null && _a !== void 0 ? _a : configDefaults.fileStrategy);
+    const startBalance = process.env.START_BALANCE;
+    const balance = (_b = config.balance) !== null && _b !== void 0 ? _b : {
+        enabled: ((_c = process.env.CHECK_BALANCE) === null || _c === void 0 ? void 0 : _c.toLowerCase().trim()) === 'true',
+        startBalance: startBalance ? parseInt(startBalance, 10) : undefined,
+    };
+    const transactions = (_d = config.transactions) !== null && _d !== void 0 ? _d : configDefaults.transactions;
+    const imageOutputType = (_e = config === null || config === void 0 ? void 0 : config.imageOutputType) !== null && _e !== void 0 ? _e : configDefaults.imageOutputType;
+    process.env.CDN_PROVIDER = fileStrategy;
+    const availableTools = systemTools;
+    const mcpConfig = config.mcpServers || null;
+    const registration = (_f = config.registration) !== null && _f !== void 0 ? _f : configDefaults.registration;
+    const interfaceConfig = await loadDefaultInterface({ config, configDefaults });
+    const turnstileConfig = loadTurnstileConfig(config, configDefaults);
+    const speech = config.speech;
+    const defaultConfig = {
+        ocr,
+        paths,
+        config,
+        memory,
+        speech,
+        balance,
+        transactions,
+        mcpConfig,
+        webSearch,
+        fileStrategy,
+        registration,
+        filteredTools,
+        includedTools,
+        availableTools,
+        imageOutputType,
+        interfaceConfig,
+        turnstileConfig,
+        fileStrategies: config.fileStrategies,
+    };
+    const agentsDefaults = agentsConfigSetup(config);
+    if (!Object.keys(config).length) {
+        const appConfig = {
+            ...defaultConfig,
+            endpoints: {
+                [EModelEndpoint.agents]: agentsDefaults,
+            },
+        };
+        return appConfig;
+    }
+    const loadedEndpoints = loadEndpoints(config, agentsDefaults);
+    const appConfig = {
+        ...defaultConfig,
+        fileConfig: config === null || config === void 0 ? void 0 : config.fileConfig,
+        secureImageLinks: config === null || config === void 0 ? void 0 : config.secureImageLinks,
+        modelSpecs: processModelSpecs(config === null || config === void 0 ? void 0 : config.endpoints, config.modelSpecs, interfaceConfig),
+        endpoints: loadedEndpoints,
+    };
+    return appConfig;
+};
+
+/**
+ * Common role combinations
+ */
+var RoleBits;
+(function (RoleBits) {
+    /** 0001 = 1 */
+    RoleBits[RoleBits["VIEWER"] = PermissionBits.VIEW] = "VIEWER";
+    /** 0011 = 3 */
+    RoleBits[RoleBits["EDITOR"] = PermissionBits.VIEW | PermissionBits.EDIT] = "EDITOR";
+    /** 0111 = 7 */
+    RoleBits[RoleBits["MANAGER"] = PermissionBits.VIEW | PermissionBits.EDIT | PermissionBits.DELETE] = "MANAGER";
+    /** 1111 = 15 */
+    RoleBits[RoleBits["OWNER"] = PermissionBits.VIEW | PermissionBits.EDIT | PermissionBits.DELETE | PermissionBits.SHARE] = "OWNER";
+})(RoleBits || (RoleBits = {}));
+
+async function signPayload({ payload, secret, expirationTime, }) {
+    return jwt.sign(payload, secret, { expiresIn: expirationTime });
+}
+async function hashToken(str) {
+    const data = new TextEncoder().encode(str);
+    const hashBuffer = await webcrypto.subtle.digest('SHA-256', data);
+    return Buffer.from(hashBuffer).toString('hex');
+}
+
+// Define the Auth sub-schema with type-safety.
+const AuthSchema = new Schema({
+    authorization_type: { type: String },
+    custom_auth_header: { type: String },
+    type: { type: String, enum: ['service_http', 'oauth', 'none'] },
+    authorization_content_type: { type: String },
+    authorization_url: { type: String },
+    client_url: { type: String },
+    scope: { type: String },
+    token_exchange_method: { type: String, enum: ['default_post', 'basic_auth_header', null] },
+}, { _id: false });
+const Action = new Schema({
+    user: {
+        type: mongoose.Schema.Types.ObjectId,
+        ref: 'User',
+        index: true,
         required: true,
     },
-    endpointType: {
-        type: String,
-    },
-    // for azureOpenAI, openAI, chatGPTBrowser only
-    model: {
-        type: String,
-        required: false,
-    },
-    // for bedrock only
-    region: {
-        type: String,
-        required: false,
-    },
-    // for azureOpenAI, openAI only
-    chatGptLabel: {
-        type: String,
-        required: false,
-    },
-    // for google only
-    examples: { type: [{ type: Schema.Types.Mixed }], default: undefined },
-    modelLabel: {
-        type: String,
-        required: false,
-    },
-    promptPrefix: {
+    action_id: {
         type: String,
-        required: false,
-    },
-    temperature: {
-        type: Number,
-        required: false,
-    },
-    top_p: {
-        type: Number,
-        required: false,
-    },
-    // for google only
-    topP: {
-        type: Number,
-        required: false,
-    },
-    topK: {
-        type: Number,
-        required: false,
-    },
-    maxOutputTokens: {
-        type: Number,
-        required: false,
-    },
-    maxTokens: {
-        type: Number,
-        required: false,
-    },
-    presence_penalty: {
-        type: Number,
-        required: false,
-    },
-    frequency_penalty: {
-        type: Number,
-        required: false,
-    },
-    file_ids: { type: [{ type: String }], default: undefined },
-    // deprecated
-    resendImages: {
-        type: Boolean,
-    },
-    /* Anthropic only */
-    promptCache: {
-        type: Boolean,
-    },
-    thinking: {
-        type: Boolean,
-    },
-    thinkingBudget: {
-        type: Number,
+        index: true,
+        required: true,
     },
-    system: {
+    type: {
         type: String,
+        default: 'action_prototype',
     },
-    // files
-    resendFiles: {
-        type: Boolean,
+    settings: Schema.Types.Mixed,
+    agent_id: String,
+    assistant_id: String,
+    metadata: {
+        api_key: String,
+        auth: AuthSchema,
+        domain: {
+            type: String,
+            required: true,
+        },
+        privacy_policy_url: String,
+        raw_spec: String,
+        oauth_client_id: String,
+        oauth_client_secret: String,
     },
-    imageDetail: {
+});
+
+const agentSchema = new Schema({
+    id: {
         type: String,
+        index: true,
+        unique: true,
+        required: true,
     },
-    /* agents */
-    agent_id: {
+    name: {
         type: String,
     },
-    /* assistants */
-    assistant_id: {
+    description: {
         type: String,
     },
     instructions: {
         type: String,
     },
-    stop: { type: [{ type: String }], default: undefined },
-    isArchived: {
-        type: Boolean,
-        default: false,
-    },
-    /* UI Components */
-    iconURL: {
-        type: String,
-    },
-    greeting: {
-        type: String,
-    },
-    spec: {
-        type: String,
-    },
-    tags: {
-        type: [String],
-        default: [],
-    },
-    tools: { type: [{ type: String }], default: undefined },
-    maxContextTokens: {
-        type: Number,
-    },
-    max_tokens: {
-        type: Number,
-    },
-    useResponsesApi: {
-        type: Boolean,
-    },
-    /** OpenAI Responses API / Anthropic API / Google API */
-    web_search: {
-        type: Boolean,
-    },
-    disableStreaming: {
-        type: Boolean,
-    },
-    fileTokenLimit: {
-        type: Number,
-    },
-    /** Reasoning models only */
-    reasoning_effort: {
-        type: String,
-    },
-    reasoning_summary: {
-        type: String,
+    avatar: {
+        type: Schema.Types.Mixed,
+        default: undefined,
     },
-    /** Verbosity control */
-    verbosity: {
+    provider: {
         type: String,
+        required: true,
     },
-};
-
-const convoSchema = new Schema({
-    conversationId: {
+    model: {
         type: String,
-        unique: true,
         required: true,
-        index: true,
-        meiliIndex: true,
     },
-    title: {
-        type: String,
-        default: 'New Chat',
-        meiliIndex: true,
+    model_parameters: {
+        type: Object,
     },
-    user: {
+    artifacts: {
         type: String,
-        index: true,
-        meiliIndex: true,
     },
-    messages: [{ type: Schema.Types.ObjectId, ref: 'Message' }],
-    agentOptions: {
-        type: Schema.Types.Mixed,
+    access_level: {
+        type: Number,
     },
-    ...conversationPreset,
-    agent_id: {
-        type: String,
+    recursion_limit: {
+        type: Number,
     },
-    tags: {
+    tools: {
         type: [String],
-        default: [],
-        meiliIndex: true,
+        default: undefined,
     },
-    files: {
-        type: [String],
+    tool_kwargs: {
+        type: [{ type: Schema.Types.Mixed }],
     },
-    expiredAt: {
-        type: Date,
+    actions: {
+        type: [String],
+        default: undefined,
     },
-}, { timestamps: true });
-convoSchema.index({ expiredAt: 1 }, { expireAfterSeconds: 0 });
-convoSchema.index({ createdAt: 1, updatedAt: 1 });
-convoSchema.index({ conversationId: 1, user: 1 }, { unique: true });
-
-const file = new Schema({
-    user: {
-        type: mongoose.Schema.Types.ObjectId,
+    author: {
+        type: Schema.Types.ObjectId,
         ref: 'User',
-        index: true,
-        required: true,
-    },
-    conversationId: {
-        type: String,
-        ref: 'Conversation',
-        index: true,
-    },
-    file_id: {
-        type: String,
-        index: true,
         required: true,
     },
-    temp_file_id: {
+    authorName: {
         type: String,
+        default: undefined,
     },
-    bytes: {
-        type: Number,
-        required: true,
+    hide_sequential_outputs: {
+        type: Boolean,
     },
-    filename: {
-        type: String,
-        required: true,
+    end_after_tools: {
+        type: Boolean,
     },
-    filepath: {
-        type: String,
-        required: true,
+    /** @deprecated Use edges instead */
+    agent_ids: {
+        type: [String],
     },
-    object: {
-        type: String,
-        required: true,
-        default: 'file',
+    edges: {
+        type: [{ type: Schema.Types.Mixed }],
+        default: [],
     },
-    embedded: {
+    isCollaborative: {
         type: Boolean,
+        default: undefined,
     },
-    type: {
-        type: String,
-        required: true,
-    },
-    text: {
-        type: String,
+    conversation_starters: {
+        type: [String],
+        default: [],
     },
-    context: {
-        type: String,
+    tool_resources: {
+        type: Schema.Types.Mixed,
+        default: {},
     },
-    usage: {
-        type: Number,
-        required: true,
-        default: 0,
+    projectIds: {
+        type: [Schema.Types.ObjectId],
+        ref: 'Project',
+        index: true,
     },
-    source: {
-        type: String,
-        default: FileSources.local,
+    versions: {
+        type: [Schema.Types.Mixed],
+        default: [],
     },
-    model: {
+    category: {
         type: String,
+        trim: true,
+        index: true,
+        default: 'general',
     },
-    width: Number,
-    height: Number,
-    metadata: {
-        fileIdentifier: String,
+    support_contact: {
+        type: Schema.Types.Mixed,
+        default: undefined,
     },
-    expiresAt: {
-        type: Date,
-        expires: 3600, // 1 hour in seconds
+    is_promoted: {
+        type: Boolean,
+        default: false,
+        index: true,
     },
 }, {
     timestamps: true,
 });
-file.index({ createdAt: 1, updatedAt: 1 });
+agentSchema.index({ updatedAt: -1, _id: 1 });
 
-const keySchema = new Schema({
-    userId: {
-        type: mongoose.Schema.Types.ObjectId,
-        ref: 'User',
-        required: true,
-    },
-    name: {
-        type: String,
-        required: true,
-    },
+const agentCategorySchema = new Schema({
     value: {
         type: String,
         required: true,
-    },
-    expiresAt: {
-        type: Date,
-    },
-});
-keySchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 });
-
-const messageSchema = new Schema({
-    messageId: {
-        type: String,
         unique: true,
-        required: true,
-        index: true,
-        meiliIndex: true,
-    },
-    conversationId: {
-        type: String,
+        trim: true,
+        lowercase: true,
         index: true,
-        required: true,
-        meiliIndex: true,
     },
-    user: {
+    label: {
         type: String,
-        index: true,
         required: true,
-        default: null,
-        meiliIndex: true,
-    },
-    model: {
-        type: String,
-        default: null,
-    },
-    endpoint: {
-        type: String,
-    },
-    conversationSignature: {
-        type: String,
+        trim: true,
     },
-    clientId: {
+    description: {
         type: String,
+        trim: true,
+        default: '',
     },
-    invocationId: {
+    order: {
         type: Number,
+        default: 0,
+        index: true,
     },
-    parentMessageId: {
-        type: String,
-    },
-    tokenCount: {
-        type: Number,
+    isActive: {
+        type: Boolean,
+        default: true,
+        index: true,
     },
-    summaryTokenCount: {
-        type: Number,
+    custom: {
+        type: Boolean,
+        default: false,
     },
-    sender: {
-        type: String,
-        meiliIndex: true,
+}, {
+    timestamps: true,
+});
+agentCategorySchema.index({ isActive: 1, order: 1 });
+agentCategorySchema.index({ order: 1, label: 1 });
+
+const assistantSchema = new Schema({
+    user: {
+        type: Schema.Types.ObjectId,
+        ref: 'User',
+        required: true,
     },
-    text: {
+    assistant_id: {
         type: String,
-        meiliIndex: true,
+        index: true,
+        required: true,
     },
-    summary: {
-        type: String,
+    avatar: {
+        type: Schema.Types.Mixed,
+        default: undefined,
     },
-    isCreatedByUser: {
-        type: Boolean,
-        required: true,
-        default: false,
+    conversation_starters: {
+        type: [String],
+        default: [],
     },
-    unfinished: {
-        type: Boolean,
-        default: false,
+    access_level: {
+        type: Number,
     },
-    error: {
+    file_ids: { type: [String], default: undefined },
+    actions: { type: [String], default: undefined },
+    append_current_datetime: {
         type: Boolean,
         default: false,
     },
-    finish_reason: {
-        type: String,
+}, {
+    timestamps: true,
+});
+
+const balanceSchema = new Schema({
+    user: {
+        type: Schema.Types.ObjectId,
+        ref: 'User',
+        index: true,
+        required: true,
     },
-    feedback: {
-        type: {
-            rating: {
-                type: String,
-                enum: ['thumbsUp', 'thumbsDown'],
-                required: true,
-            },
-            tag: {
-                type: mongoose.Schema.Types.Mixed,
-                required: false,
-            },
-            text: {
-                type: String,
-                required: false,
-            },
-        },
-        default: undefined,
-        required: false,
+    // 1000 tokenCredits = 1 mill ($0.001 USD)
+    tokenCredits: {
+        type: Number,
+        default: 0,
     },
-    _meiliIndex: {
+    // Automatic refill settings
+    autoRefillEnabled: {
         type: Boolean,
-        required: false,
-        select: false,
         default: false,
     },
-    files: { type: [{ type: mongoose.Schema.Types.Mixed }], default: undefined },
-    plugin: {
-        type: {
-            latest: {
-                type: String,
-                required: false,
-            },
-            inputs: {
-                type: [mongoose.Schema.Types.Mixed],
-                required: false,
-                default: undefined,
-            },
-            outputs: {
-                type: String,
-                required: false,
-            },
-        },
-        default: undefined,
-    },
-    plugins: { type: [{ type: mongoose.Schema.Types.Mixed }], default: undefined },
-    content: {
-        type: [{ type: mongoose.Schema.Types.Mixed }],
-        default: undefined,
-        meiliIndex: true,
-    },
-    thread_id: {
-        type: String,
+    refillIntervalValue: {
+        type: Number,
+        default: 30,
     },
-    /* frontend components */
-    iconURL: {
+    refillIntervalUnit: {
         type: String,
+        enum: ['seconds', 'minutes', 'hours', 'days', 'weeks', 'months'],
+        default: 'days',
     },
-    attachments: { type: [{ type: mongoose.Schema.Types.Mixed }], default: undefined },
-    /*
-    attachments: {
-      type: [
-        {
-          file_id: String,
-          filename: String,
-          filepath: String,
-          expiresAt: Date,
-          width: Number,
-          height: Number,
-          type: String,
-          conversationId: String,
-          messageId: {
-            type: String,
-            required: true,
-          },
-          toolCallId: String,
-        },
-      ],
-      default: undefined,
-    },
-    */
-    expiredAt: {
+    lastRefill: {
         type: Date,
+        default: Date.now,
     },
-}, { timestamps: true });
-messageSchema.index({ expiredAt: 1 }, { expireAfterSeconds: 0 });
-messageSchema.index({ createdAt: 1 });
-messageSchema.index({ messageId: 1, user: 1 }, { unique: true });
+    // amount to add on each refill
+    refillAmount: {
+        type: Number,
+        default: 0,
+    },
+});
 
-const pluginAuthSchema = new Schema({
-    authField: {
+const bannerSchema = new Schema({
+    bannerId: {
         type: String,
         required: true,
     },
-    value: {
+    message: {
         type: String,
         required: true,
     },
-    userId: {
-        type: String,
+    displayFrom: {
+        type: Date,
         required: true,
+        default: Date.now,
     },
-    pluginKey: {
+    displayTo: {
+        type: Date,
+    },
+    type: {
         type: String,
+        enum: ['banner', 'popup'],
+        default: 'banner',
+    },
+    isPublic: {
+        type: Boolean,
+        default: false,
     },
 }, { timestamps: true });
 
-const presetSchema = new Schema({
-    presetId: {
+const categoriesSchema = new Schema({
+    label: {
         type: String,
+        required: true,
         unique: true,
+    },
+    value: {
+        type: String,
         required: true,
-        index: true,
+        unique: true,
     },
-    title: {
+});
+
+const conversationTag = new Schema({
+    tag: {
         type: String,
-        default: 'New Chat',
-        meiliIndex: true,
+        index: true,
     },
     user: {
         type: String,
-        default: null,
+        index: true,
     },
-    defaultPreset: {
-        type: Boolean,
+    description: {
+        type: String,
+        index: true,
     },
-    order: {
+    count: {
         type: Number,
+        default: 0,
     },
-    ...conversationPreset,
-    agentOptions: {
-        type: mongoose.Schema.Types.Mixed,
-        default: null,
+    position: {
+        type: Number,
+        default: 0,
+        index: true,
     },
 }, { timestamps: true });
+// Create a compound index on tag and user with unique constraint.
+conversationTag.index({ tag: 1, user: 1 }, { unique: true });
 
-const projectSchema = new Schema({
-    name: {
+// @ts-ignore
+const conversationPreset = {
+    // endpoint: [azureOpenAI, openAI, anthropic, chatGPTBrowser]
+    endpoint: {
         type: String,
+        default: null,
         required: true,
-        index: true,
-    },
-    promptGroupIds: {
-        type: [Schema.Types.ObjectId],
-        ref: 'PromptGroup',
-        default: [],
     },
-    agentIds: {
-        type: [String],
-        ref: 'Agent',
-        default: [],
+    endpointType: {
+        type: String,
     },
-}, {
-    timestamps: true,
-});
-
-const promptSchema = new Schema({
-    groupId: {
-        type: Schema.Types.ObjectId,
-        ref: 'PromptGroup',
-        required: true,
-        index: true,
+    // for azureOpenAI, openAI, chatGPTBrowser only
+    model: {
+        type: String,
+        required: false,
     },
-    author: {
-        type: Schema.Types.ObjectId,
-        ref: 'User',
-        required: true,
+    // for bedrock only
+    region: {
+        type: String,
+        required: false,
     },
-    prompt: {
+    // for azureOpenAI, openAI only
+    chatGptLabel: {
         type: String,
-        required: true,
+        required: false,
     },
-    type: {
+    // for google only
+    examples: { type: [{ type: Schema.Types.Mixed }], default: undefined },
+    modelLabel: {
         type: String,
-        enum: ['text', 'chat'],
-        required: true,
+        required: false,
     },
-}, {
-    timestamps: true,
-});
-promptSchema.index({ createdAt: 1, updatedAt: 1 });
-
-const promptGroupSchema = new Schema({
-    name: {
+    promptPrefix: {
         type: String,
-        required: true,
-        index: true,
+        required: false,
     },
-    numberOfGenerations: {
+    temperature: {
         type: Number,
-        default: 0,
+        required: false,
     },
-    oneliner: {
-        type: String,
-        default: '',
+    top_p: {
+        type: Number,
+        required: false,
     },
-    category: {
-        type: String,
-        default: '',
-        index: true,
+    // for google only
+    topP: {
+        type: Number,
+        required: false,
     },
-    projectIds: {
-        type: [Schema.Types.ObjectId],
-        ref: 'Project',
-        index: true,
-        default: [],
+    topK: {
+        type: Number,
+        required: false,
     },
-    productionId: {
-        type: Schema.Types.ObjectId,
-        ref: 'Prompt',
-        required: true,
-        index: true,
+    maxOutputTokens: {
+        type: Number,
+        required: false,
     },
-    author: {
-        type: Schema.Types.ObjectId,
-        ref: 'User',
-        required: true,
-        index: true,
+    maxTokens: {
+        type: Number,
+        required: false,
     },
-    authorName: {
+    presence_penalty: {
+        type: Number,
+        required: false,
+    },
+    frequency_penalty: {
+        type: Number,
+        required: false,
+    },
+    file_ids: { type: [{ type: String }], default: undefined },
+    // deprecated
+    resendImages: {
+        type: Boolean,
+    },
+    /* Anthropic only */
+    promptCache: {
+        type: Boolean,
+    },
+    thinking: {
+        type: Boolean,
+    },
+    thinkingBudget: {
+        type: Number,
+    },
+    system: {
         type: String,
-        required: true,
     },
-    command: {
+    // files
+    resendFiles: {
+        type: Boolean,
+    },
+    imageDetail: {
         type: String,
-        index: true,
-        validate: {
-            validator: function (v) {
-                return v === undefined || v === null || v === '' || /^[a-z0-9-]+$/.test(v);
-            },
-            message: (props) => { var _a; return `${(_a = props === null || props === void 0 ? void 0 : props.value) !== null && _a !== void 0 ? _a : 'Value'} is not a valid command. Only lowercase alphanumeric characters and hyphens are allowed.`; },
-        },
-        maxlength: [
-            Constants.COMMANDS_MAX_LENGTH,
-            `Command cannot be longer than ${Constants.COMMANDS_MAX_LENGTH} characters`,
-        ],
-    }, // Casting here bypasses the type error for the command field.
-}, {
-    timestamps: true,
-});
-promptGroupSchema.index({ createdAt: 1, updatedAt: 1 });
-
-/**
- * Uses a sub-schema for permissions. Notice we disable `_id` for this subdocument.
- */
-const rolePermissionsSchema = new Schema({
-    [PermissionTypes.BOOKMARKS]: {
-        [Permissions.USE]: { type: Boolean },
     },
-    [PermissionTypes.PROMPTS]: {
-        [Permissions.SHARED_GLOBAL]: { type: Boolean },
-        [Permissions.USE]: { type: Boolean },
-        [Permissions.CREATE]: { type: Boolean },
+    /* agents */
+    agent_id: {
+        type: String,
     },
-    [PermissionTypes.MEMORIES]: {
-        [Permissions.USE]: { type: Boolean },
-        [Permissions.CREATE]: { type: Boolean },
-        [Permissions.UPDATE]: { type: Boolean },
-        [Permissions.READ]: { type: Boolean },
-        [Permissions.OPT_OUT]: { type: Boolean },
+    /* assistants */
+    assistant_id: {
+        type: String,
+    },
+    instructions: {
+        type: String,
     },
-    [PermissionTypes.AGENTS]: {
-        [Permissions.SHARED_GLOBAL]: { type: Boolean },
-        [Permissions.USE]: { type: Boolean },
-        [Permissions.CREATE]: { type: Boolean },
+    stop: { type: [{ type: String }], default: undefined },
+    isArchived: {
+        type: Boolean,
+        default: false,
     },
-    [PermissionTypes.MULTI_CONVO]: {
-        [Permissions.USE]: { type: Boolean },
+    /* UI Components */
+    iconURL: {
+        type: String,
     },
-    [PermissionTypes.TEMPORARY_CHAT]: {
-        [Permissions.USE]: { type: Boolean },
+    greeting: {
+        type: String,
     },
-    [PermissionTypes.RUN_CODE]: {
-        [Permissions.USE]: { type: Boolean },
+    spec: {
+        type: String,
     },
-    [PermissionTypes.WEB_SEARCH]: {
-        [Permissions.USE]: { type: Boolean },
+    tags: {
+        type: [String],
+        default: [],
     },
-    [PermissionTypes.PEOPLE_PICKER]: {
-        [Permissions.VIEW_USERS]: { type: Boolean },
-        [Permissions.VIEW_GROUPS]: { type: Boolean },
-        [Permissions.VIEW_ROLES]: { type: Boolean },
+    tools: { type: [{ type: String }], default: undefined },
+    maxContextTokens: {
+        type: Number,
     },
-    [PermissionTypes.MARKETPLACE]: {
-        [Permissions.USE]: { type: Boolean },
+    max_tokens: {
+        type: Number,
     },
-    [PermissionTypes.FILE_SEARCH]: {
-        [Permissions.USE]: { type: Boolean },
+    useResponsesApi: {
+        type: Boolean,
     },
-    [PermissionTypes.FILE_CITATIONS]: {
-        [Permissions.USE]: { type: Boolean },
+    /** OpenAI Responses API / Anthropic API / Google API */
+    web_search: {
+        type: Boolean,
     },
-}, { _id: false });
-const roleSchema = new Schema({
-    name: { type: String, required: true, unique: true, index: true },
-    permissions: {
-        type: rolePermissionsSchema,
+    disableStreaming: {
+        type: Boolean,
     },
-});
-
-const sessionSchema = new Schema({
-    refreshTokenHash: {
+    fileTokenLimit: {
+        type: Number,
+    },
+    /** Reasoning models only */
+    reasoning_effort: {
         type: String,
-        required: true,
     },
-    expiration: {
-        type: Date,
-        required: true,
-        expires: 0,
+    reasoning_summary: {
+        type: String,
     },
-    user: {
-        type: mongoose.Schema.Types.ObjectId,
-        ref: 'User',
-        required: true,
+    /** Verbosity control */
+    verbosity: {
+        type: String,
     },
-});
+};
 
-const shareSchema = new Schema({
+const convoSchema = new Schema({
     conversationId: {
         type: String,
+        unique: true,
         required: true,
+        index: true,
+        meiliIndex: true,
     },
     title: {
         type: String,
-        index: true,
+        default: 'New Chat',
+        meiliIndex: true,
     },
     user: {
         type: String,
         index: true,
+        meiliIndex: true,
     },
-    messages: [{ type: mongoose.Schema.Types.ObjectId, ref: 'Message' }],
-    shareId: {
+    messages: [{ type: Schema.Types.ObjectId, ref: 'Message' }],
+    agentOptions: {
+        type: Schema.Types.Mixed,
+    },
+    ...conversationPreset,
+    agent_id: {
         type: String,
-        index: true,
     },
-    isPublic: {
-        type: Boolean,
-        default: true,
+    tags: {
+        type: [String],
+        default: [],
+        meiliIndex: true,
+    },
+    files: {
+        type: [String],
+    },
+    expiredAt: {
+        type: Date,
     },
 }, { timestamps: true });
+convoSchema.index({ expiredAt: 1 }, { expireAfterSeconds: 0 });
+convoSchema.index({ createdAt: 1, updatedAt: 1 });
+convoSchema.index({ conversationId: 1, user: 1 }, { unique: true });
 
-const tokenSchema = new Schema({
-    userId: {
-        type: Schema.Types.ObjectId,
+const file = new Schema({
+    user: {
+        type: mongoose.Schema.Types.ObjectId,
+        ref: 'User',
+        index: true,
         required: true,
-        ref: 'user',
-    },
-    email: {
-        type: String,
     },
-    type: {
-        type: String,
-    },
-    identifier: {
+    conversationId: {
         type: String,
+        ref: 'Conversation',
+        index: true,
     },
-    token: {
+    file_id: {
         type: String,
+        index: true,
         required: true,
     },
-    createdAt: {
-        type: Date,
-        required: true,
-        default: Date.now,
+    temp_file_id: {
+        type: String,
     },
-    expiresAt: {
-        type: Date,
+    bytes: {
+        type: Number,
         required: true,
     },
-    metadata: {
-        type: Map,
-        of: Schema.Types.Mixed,
-    },
-});
-tokenSchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 });
-
-const toolCallSchema = new Schema({
-    conversationId: {
+    filename: {
         type: String,
         required: true,
     },
-    messageId: {
+    filepath: {
         type: String,
         required: true,
     },
-    toolId: {
+    object: {
         type: String,
         required: true,
+        default: 'file',
     },
-    user: {
-        type: mongoose.Schema.Types.ObjectId,
-        ref: 'User',
-        required: true,
+    embedded: {
+        type: Boolean,
     },
-    result: {
-        type: mongoose.Schema.Types.Mixed,
+    type: {
+        type: String,
+        required: true,
     },
-    attachments: {
-        type: mongoose.Schema.Types.Mixed,
+    text: {
+        type: String,
     },
-    blockIndex: {
-        type: Number,
+    context: {
+        type: String,
     },
-    partIndex: {
+    usage: {
         type: Number,
-    },
-}, { timestamps: true });
-toolCallSchema.index({ messageId: 1, user: 1 });
-toolCallSchema.index({ conversationId: 1, user: 1 });
-
-const transactionSchema = new Schema({
-    user: {
-        type: mongoose.Schema.Types.ObjectId,
-        ref: 'User',
-        index: true,
         required: true,
+        default: 0,
     },
-    conversationId: {
-        type: String,
-        ref: 'Conversation',
-        index: true,
-    },
-    tokenType: {
+    source: {
         type: String,
-        enum: ['prompt', 'completion', 'credits'],
-        required: true,
+        default: FileSources.local,
     },
     model: {
         type: String,
     },
-    context: {
-        type: String,
+    width: Number,
+    height: Number,
+    metadata: {
+        fileIdentifier: String,
     },
-    valueKey: {
-        type: String,
+    expiresAt: {
+        type: Date,
+        expires: 3600, // 1 hour in seconds
     },
-    rate: Number,
-    rawAmount: Number,
-    tokenValue: Number,
-    inputTokens: { type: Number },
-    writeTokens: { type: Number },
-    readTokens: { type: Number },
 }, {
     timestamps: true,
 });
+file.index({ createdAt: 1, updatedAt: 1 });
 
-// Session sub-schema
-const SessionSchema = new Schema({
-    refreshToken: {
-        type: String,
-        default: '',
+const keySchema = new Schema({
+    userId: {
+        type: mongoose.Schema.Types.ObjectId,
+        ref: 'User',
+        required: true,
     },
-}, { _id: false });
-// Backup code sub-schema
-const BackupCodeSchema = new Schema({
-    codeHash: { type: String, required: true },
-    used: { type: Boolean, default: false },
-    usedAt: { type: Date, default: null },
-}, { _id: false });
-const userSchema = new Schema({
     name: {
         type: String,
+        required: true,
     },
-    username: {
+    value: {
         type: String,
-        lowercase: true,
-        default: '',
+        required: true,
     },
-    email: {
+    expiresAt: {
+        type: Date,
+    },
+});
+keySchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 });
+
+const messageSchema = new Schema({
+    messageId: {
         type: String,
-        required: [true, "can't be blank"],
-        lowercase: true,
         unique: true,
-        match: [/\S+@\S+\.\S+/, 'is invalid'],
+        required: true,
         index: true,
+        meiliIndex: true,
     },
-    emailVerified: {
-        type: Boolean,
+    conversationId: {
+        type: String,
+        index: true,
         required: true,
-        default: false,
+        meiliIndex: true,
     },
-    password: {
+    user: {
         type: String,
-        trim: true,
-        minlength: 8,
-        maxlength: 128,
-        select: false,
+        index: true,
+        required: true,
+        default: null,
+        meiliIndex: true,
     },
-    avatar: {
+    model: {
         type: String,
-        required: false,
+        default: null,
     },
-    provider: {
+    endpoint: {
         type: String,
-        required: true,
-        default: 'local',
     },
-    role: {
+    conversationSignature: {
         type: String,
-        default: SystemRoles.USER,
     },
-    googleId: {
+    clientId: {
         type: String,
-        unique: true,
-        sparse: true,
     },
-    facebookId: {
-        type: String,
-        unique: true,
-        sparse: true,
+    invocationId: {
+        type: Number,
     },
-    openidId: {
+    parentMessageId: {
         type: String,
-        unique: true,
-        sparse: true,
     },
-    samlId: {
-        type: String,
-        unique: true,
-        sparse: true,
+    tokenCount: {
+        type: Number,
     },
-    ldapId: {
-        type: String,
-        unique: true,
-        sparse: true,
+    summaryTokenCount: {
+        type: Number,
     },
-    githubId: {
+    sender: {
         type: String,
-        unique: true,
-        sparse: true,
+        meiliIndex: true,
     },
-    discordId: {
+    text: {
         type: String,
-        unique: true,
-        sparse: true,
+        meiliIndex: true,
     },
-    appleId: {
+    summary: {
         type: String,
-        unique: true,
-        sparse: true,
-    },
-    plugins: {
-        type: Array,
     },
-    twoFactorEnabled: {
+    isCreatedByUser: {
         type: Boolean,
+        required: true,
         default: false,
     },
-    totpSecret: {
-        type: String,
-        select: false,
+    unfinished: {
+        type: Boolean,
+        default: false,
     },
-    backupCodes: {
-        type: [BackupCodeSchema],
-        select: false,
+    error: {
+        type: Boolean,
+        default: false,
     },
-    refreshToken: {
-        type: [SessionSchema],
+    finish_reason: {
+        type: String,
     },
-    expiresAt: {
-        type: Date,
-        expires: 604800, // 7 days in seconds
+    feedback: {
+        type: {
+            rating: {
+                type: String,
+                enum: ['thumbsUp', 'thumbsDown'],
+                required: true,
+            },
+            tag: {
+                type: mongoose.Schema.Types.Mixed,
+                required: false,
+            },
+            text: {
+                type: String,
+                required: false,
+            },
+        },
+        default: undefined,
+        required: false,
     },
-    termsAccepted: {
+    _meiliIndex: {
         type: Boolean,
+        required: false,
+        select: false,
         default: false,
     },
-    personalization: {
+    files: { type: [{ type: mongoose.Schema.Types.Mixed }], default: undefined },
+    plugin: {
         type: {
-            memories: {
-                type: Boolean,
-                default: true,
+            latest: {
+                type: String,
+                required: false,
+            },
+            inputs: {
+                type: [mongoose.Schema.Types.Mixed],
+                required: false,
+                default: undefined,
+            },
+            outputs: {
+                type: String,
+                required: false,
             },
         },
-        default: {},
+        default: undefined,
     },
-    /** Field for external source identification (for consistency with TPrincipal schema) */
-    idOnTheSource: {
+    plugins: { type: [{ type: mongoose.Schema.Types.Mixed }], default: undefined },
+    content: {
+        type: [{ type: mongoose.Schema.Types.Mixed }],
+        default: undefined,
+        meiliIndex: true,
+    },
+    thread_id: {
         type: String,
-        sparse: true,
+    },
+    /* frontend components */
+    iconURL: {
+        type: String,
+    },
+    metadata: { type: mongoose.Schema.Types.Mixed },
+    attachments: { type: [{ type: mongoose.Schema.Types.Mixed }], default: undefined },
+    /*
+    attachments: {
+      type: [
+        {
+          file_id: String,
+          filename: String,
+          filepath: String,
+          expiresAt: Date,
+          width: Number,
+          height: Number,
+          type: String,
+          conversationId: String,
+          messageId: {
+            type: String,
+            required: true,
+          },
+          toolCallId: String,
+        },
+      ],
+      default: undefined,
+    },
+    */
+    expiredAt: {
+        type: Date,
     },
 }, { timestamps: true });
+messageSchema.index({ expiredAt: 1 }, { expireAfterSeconds: 0 });
+messageSchema.index({ createdAt: 1 });
+messageSchema.index({ messageId: 1, user: 1 }, { unique: true });
 
-const MemoryEntrySchema = new Schema({
-    userId: {
-        type: Schema.Types.ObjectId,
-        ref: 'User',
-        index: true,
+const pluginAuthSchema = new Schema({
+    authField: {
+        type: String,
         required: true,
     },
-    key: {
+    value: {
         type: String,
         required: true,
-        validate: {
-            validator: (v) => /^[a-z_]+$/.test(v),
-            message: 'Key must only contain lowercase letters and underscores',
-        },
     },
-    value: {
+    userId: {
         type: String,
         required: true,
     },
-    tokenCount: {
+    pluginKey: {
+        type: String,
+    },
+}, { timestamps: true });
+
+const presetSchema = new Schema({
+    presetId: {
+        type: String,
+        unique: true,
+        required: true,
+        index: true,
+    },
+    title: {
+        type: String,
+        default: 'New Chat',
+        meiliIndex: true,
+    },
+    user: {
+        type: String,
+        default: null,
+    },
+    defaultPreset: {
+        type: Boolean,
+    },
+    order: {
         type: Number,
-        default: 0,
     },
-    updated_at: {
-        type: Date,
-        default: Date.now,
+    ...conversationPreset,
+    agentOptions: {
+        type: mongoose.Schema.Types.Mixed,
+        default: null,
     },
-});
+}, { timestamps: true });
 
-const groupSchema = new Schema({
+const projectSchema = new Schema({
     name: {
         type: String,
         required: true,
         index: true,
     },
-    description: {
-        type: String,
-        required: false,
+    promptGroupIds: {
+        type: [Schema.Types.ObjectId],
+        ref: 'PromptGroup',
+        default: [],
     },
-    email: {
-        type: String,
-        required: false,
+    agentIds: {
+        type: [String],
+        ref: 'Agent',
+        default: [],
+    },
+}, {
+    timestamps: true,
+});
+
+const promptSchema = new Schema({
+    groupId: {
+        type: Schema.Types.ObjectId,
+        ref: 'PromptGroup',
+        required: true,
         index: true,
     },
-    avatar: {
-        type: String,
-        required: false,
+    author: {
+        type: Schema.Types.ObjectId,
+        ref: 'User',
+        required: true,
     },
-    memberIds: [
-        {
-            type: String,
-            required: false,
-        },
-    ],
-    source: {
+    prompt: {
         type: String,
-        enum: ['local', 'entra'],
-        default: 'local',
+        required: true,
     },
-    /** External ID (e.g., Entra ID) */
-    idOnTheSource: {
+    type: {
         type: String,
-        sparse: true,
-        index: true,
-        required: function () {
-            return this.source !== 'local';
-        },
+        enum: ['text', 'chat'],
+        required: true,
     },
-}, { timestamps: true });
-groupSchema.index({ idOnTheSource: 1, source: 1 }, {
-    unique: true,
-    partialFilterExpression: { idOnTheSource: { $exists: true } },
+}, {
+    timestamps: true,
 });
-groupSchema.index({ memberIds: 1 });
-
-/**
- * ESM-native object traversal utility
- * Simplified implementation focused on the forEach use case
- */
-function isObject(value) {
-    if (value === null || typeof value !== 'object') {
-        return false;
-    }
-    // Treat these built-in types as leaf nodes, not objects to traverse
-    if (value instanceof Date)
-        return false;
-    if (value instanceof RegExp)
-        return false;
-    if (value instanceof Error)
-        return false;
-    if (value instanceof URL)
-        return false;
-    // Check for Buffer (Node.js)
-    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value))
-        return false;
-    // Check for TypedArrays and ArrayBuffer
-    if (ArrayBuffer.isView(value))
-        return false;
-    if (value instanceof ArrayBuffer)
-        return false;
-    if (value instanceof SharedArrayBuffer)
-        return false;
-    // Check for other built-in types that shouldn't be traversed
-    if (value instanceof Promise)
-        return false;
-    if (value instanceof WeakMap)
-        return false;
-    if (value instanceof WeakSet)
-        return false;
-    if (value instanceof Map)
-        return false;
-    if (value instanceof Set)
-        return false;
-    // Check if it's a primitive wrapper object
-    const stringTag = Object.prototype.toString.call(value);
-    if (stringTag === '[object Boolean]' ||
-        stringTag === '[object Number]' ||
-        stringTag === '[object String]') {
-        return false;
-    }
-    return true;
-}
-// Helper to safely set a property on an object or array
-function setProperty(obj, key, value) {
-    if (Array.isArray(obj) && typeof key === 'number') {
-        obj[key] = value;
-    }
-    else if (!Array.isArray(obj) && typeof key === 'string') {
-        obj[key] = value;
-    }
-    else if (!Array.isArray(obj) && typeof key === 'number') {
-        // Handle numeric keys on objects
-        obj[key] = value;
-    }
-}
-// Helper to safely delete a property from an object
-function deleteProperty(obj, key) {
-    if (Array.isArray(obj) && typeof key === 'number') {
-        // For arrays, we should use splice, but this is handled in remove()
-        // This function is only called for non-array deletion
-        return;
-    }
-    if (!Array.isArray(obj)) {
-        delete obj[key];
-    }
-}
-function forEach(obj, callback) {
-    const visited = new WeakSet();
-    function walk(node, path = [], parent) {
-        // Check for circular references
-        let circular = null;
-        if (isObject(node)) {
-            if (visited.has(node)) {
-                // Find the circular reference in the parent chain
-                let p = parent;
-                while (p) {
-                    if (p.node === node) {
-                        circular = p;
-                        break;
-                    }
-                    p = p.parent;
-                }
-                return; // Skip circular references
-            }
-            visited.add(node);
-        }
-        const key = path.length > 0 ? path[path.length - 1] : undefined;
-        const isRoot = path.length === 0;
-        const level = path.length;
-        // Determine if this is a leaf node
-        const isLeaf = !isObject(node) ||
-            (Array.isArray(node) && node.length === 0) ||
-            Object.keys(node).length === 0;
-        // Create context
-        const context = {
-            node,
-            path: [...path],
-            parent,
-            key,
-            isLeaf,
-            notLeaf: !isLeaf,
-            isRoot,
-            notRoot: !isRoot,
-            level,
-            circular,
-            update(value) {
-                if (!isRoot && parent && key !== undefined && isObject(parent.node)) {
-                    setProperty(parent.node, key, value);
-                }
-                this.node = value;
-            },
-            remove() {
-                if (!isRoot && parent && key !== undefined && isObject(parent.node)) {
-                    if (Array.isArray(parent.node) && typeof key === 'number') {
-                        parent.node.splice(key, 1);
-                    }
-                    else {
-                        deleteProperty(parent.node, key);
-                    }
-                }
-            },
-        };
-        // Call the callback with the context
-        callback.call(context, node);
-        // Traverse children if not circular and is an object
-        if (!circular && isObject(node) && !isLeaf) {
-            if (Array.isArray(node)) {
-                for (let i = 0; i < node.length; i++) {
-                    walk(node[i], [...path, i], context);
-                }
-            }
-            else {
-                for (const [childKey, childValue] of Object.entries(node)) {
-                    walk(childValue, [...path, childKey], context);
-                }
-            }
-        }
-    }
-    walk(obj);
-}
-// Main traverse function that returns an object with forEach method
-function traverse(obj) {
-    return {
-        forEach(callback) {
-            forEach(obj, callback);
-        },
-    };
-}
+promptSchema.index({ createdAt: 1, updatedAt: 1 });
 
-const SPLAT_SYMBOL = Symbol.for('splat');
-const MESSAGE_SYMBOL = Symbol.for('message');
-const CONSOLE_JSON_STRING_LENGTH = parseInt(process.env.CONSOLE_JSON_STRING_LENGTH || '', 10) || 255;
-const sensitiveKeys = [
-    /^(sk-)[^\s]+/, // OpenAI API key pattern
-    /(Bearer )[^\s]+/, // Header: Bearer token pattern
-    /(api-key:? )[^\s]+/, // Header: API key pattern
-    /(key=)[^\s]+/, // URL query param: sensitive key pattern (Google)
-];
-/**
- * Determines if a given value string is sensitive and returns matching regex patterns.
- *
- * @param valueStr - The value string to check.
- * @returns An array of regex patterns that match the value string.
- */
-function getMatchingSensitivePatterns(valueStr) {
-    if (valueStr) {
-        // Filter and return all regex patterns that match the value string
-        return sensitiveKeys.filter((regex) => regex.test(valueStr));
-    }
-    return [];
-}
-/**
- * Redacts sensitive information from a console message and trims it to a specified length if provided.
- * @param str - The console message to be redacted.
- * @param trimLength - The optional length at which to trim the redacted message.
- * @returns The redacted and optionally trimmed console message.
- */
-function redactMessage(str, trimLength) {
-    if (!str) {
-        return '';
-    }
-    const patterns = getMatchingSensitivePatterns(str);
-    patterns.forEach((pattern) => {
-        str = str.replace(pattern, '$1[REDACTED]');
-    });
-    return str;
-}
-/**
- * Redacts sensitive information from log messages if the log level is 'error'.
- * Note: Intentionally mutates the object.
- * @param info - The log information object.
- * @returns The modified log information object.
- */
-const redactFormat = winston.format((info) => {
-    if (info.level === 'error') {
-        // Type guard to ensure message is a string
-        if (typeof info.message === 'string') {
-            info.message = redactMessage(info.message);
-        }
-        // Handle MESSAGE_SYMBOL with type safety
-        const symbolValue = info[MESSAGE_SYMBOL];
-        if (typeof symbolValue === 'string') {
-            info[MESSAGE_SYMBOL] = redactMessage(symbolValue);
-        }
-    }
-    return info;
+const promptGroupSchema = new Schema({
+    name: {
+        type: String,
+        required: true,
+        index: true,
+    },
+    numberOfGenerations: {
+        type: Number,
+        default: 0,
+    },
+    oneliner: {
+        type: String,
+        default: '',
+    },
+    category: {
+        type: String,
+        default: '',
+        index: true,
+    },
+    projectIds: {
+        type: [Schema.Types.ObjectId],
+        ref: 'Project',
+        index: true,
+        default: [],
+    },
+    productionId: {
+        type: Schema.Types.ObjectId,
+        ref: 'Prompt',
+        required: true,
+        index: true,
+    },
+    author: {
+        type: Schema.Types.ObjectId,
+        ref: 'User',
+        required: true,
+        index: true,
+    },
+    authorName: {
+        type: String,
+        required: true,
+    },
+    command: {
+        type: String,
+        index: true,
+        validate: {
+            validator: function (v) {
+                return v === undefined || v === null || v === '' || /^[a-z0-9-]+$/.test(v);
+            },
+            message: (props) => { var _a; return `${(_a = props === null || props === void 0 ? void 0 : props.value) !== null && _a !== void 0 ? _a : 'Value'} is not a valid command. Only lowercase alphanumeric characters and hyphens are allowed.`; },
+        },
+        maxlength: [
+            Constants.COMMANDS_MAX_LENGTH,
+            `Command cannot be longer than ${Constants.COMMANDS_MAX_LENGTH} characters`,
+        ],
+    }, // Casting here bypasses the type error for the command field.
+}, {
+    timestamps: true,
 });
+promptGroupSchema.index({ createdAt: 1, updatedAt: 1 });
+
 /**
- * Truncates long strings, especially base64 image data, within log messages.
- *
- * @param value - The value to be inspected and potentially truncated.
- * @param length - The length at which to truncate the value. Default: 100.
- * @returns The truncated or original value.
- */
-const truncateLongStrings = (value, length = 100) => {
-    if (typeof value === 'string') {
-        return value.length > length ? value.substring(0, length) + '... [truncated]' : value;
-    }
-    return value;
-};
-/**
- * An array mapping function that truncates long strings (objects converted to JSON strings).
- * @param item - The item to be condensed.
- * @returns The condensed item.
- */
-const condenseArray = (item) => {
-    if (typeof item === 'string') {
-        return truncateLongStrings(JSON.stringify(item));
-    }
-    else if (typeof item === 'object') {
-        return truncateLongStrings(JSON.stringify(item));
-    }
-    return item;
-};
-/**
- * Formats log messages for debugging purposes.
- * - Truncates long strings within log messages.
- * - Condenses arrays by truncating long strings and objects as strings within array items.
- * - Redacts sensitive information from log messages if the log level is 'error'.
- * - Converts log information object to a formatted string.
- *
- * @param options - The options for formatting log messages.
- * @returns The formatted log message.
+ * Uses a sub-schema for permissions. Notice we disable `_id` for this subdocument.
  */
-const debugTraverse = winston.format.printf(({ level, message, timestamp, ...metadata }) => {
-    if (!message) {
-        return `${timestamp} ${level}`;
-    }
-    // Type-safe version of the CJS logic: !message?.trim || typeof message !== 'string'
-    if (typeof message !== 'string' || !message.trim) {
-        return `${timestamp} ${level}: ${JSON.stringify(message)}`;
-    }
-    const msgParts = [
-        `${timestamp} ${level}: ${truncateLongStrings(message.trim(), 150)}`,
-    ];
-    try {
-        if (level !== 'debug') {
-            return msgParts[0];
-        }
-        if (!metadata) {
-            return msgParts[0];
-        }
-        // Type-safe access to SPLAT_SYMBOL using bracket notation
-        const metadataRecord = metadata;
-        const splatArray = metadataRecord[SPLAT_SYMBOL];
-        const debugValue = Array.isArray(splatArray) ? splatArray[0] : undefined;
-        if (!debugValue) {
-            return msgParts[0];
-        }
-        if (debugValue && Array.isArray(debugValue)) {
-            msgParts.push(`\n${JSON.stringify(debugValue.map(condenseArray))}`);
-            return msgParts.join('');
-        }
-        if (typeof debugValue !== 'object') {
-            msgParts.push(` ${debugValue}`);
-            return msgParts.join('');
-        }
-        msgParts.push('\n{');
-        const copy = klona(metadata);
-        try {
-            const traversal = traverse(copy);
-            traversal.forEach(function (value) {
-                var _a;
-                if (typeof (this === null || this === void 0 ? void 0 : this.key) === 'symbol') {
-                    return;
-                }
-                let _parentKey = '';
-                const parent = this.parent;
-                if (typeof (parent === null || parent === void 0 ? void 0 : parent.key) !== 'symbol' && (parent === null || parent === void 0 ? void 0 : parent.key) !== undefined) {
-                    _parentKey = String(parent.key);
-                }
-                const parentKey = `${parent && parent.notRoot ? _parentKey + '.' : ''}`;
-                const tabs = `${parent && parent.notRoot ? '    ' : '  '}`;
-                const currentKey = (_a = this === null || this === void 0 ? void 0 : this.key) !== null && _a !== void 0 ? _a : 'unknown';
-                if (this.isLeaf && typeof value === 'string') {
-                    const truncatedText = truncateLongStrings(value);
-                    msgParts.push(`\n${tabs}${parentKey}${currentKey}: ${JSON.stringify(truncatedText)},`);
-                }
-                else if (this.notLeaf && Array.isArray(value) && value.length > 0) {
-                    const currentMessage = `\n${tabs}// ${value.length} ${String(currentKey).replace(/s$/, '')}(s)`;
-                    this.update(currentMessage);
-                    msgParts.push(currentMessage);
-                    const stringifiedArray = value.map(condenseArray);
-                    msgParts.push(`\n${tabs}${parentKey}${currentKey}: [${stringifiedArray}],`);
-                }
-                else if (this.isLeaf && typeof value === 'function') {
-                    msgParts.push(`\n${tabs}${parentKey}${currentKey}: function,`);
-                }
-                else if (this.isLeaf) {
-                    msgParts.push(`\n${tabs}${parentKey}${currentKey}: ${value},`);
-                }
-            });
-        }
-        catch (e) {
-            const errorMessage = e instanceof Error ? e.message : 'Unknown error';
-            msgParts.push(`\n[LOGGER TRAVERSAL ERROR] ${errorMessage}`);
-        }
-        msgParts.push('\n}');
-        return msgParts.join('');
-    }
-    catch (e) {
-        const errorMessage = e instanceof Error ? e.message : 'Unknown error';
-        msgParts.push(`\n[LOGGER PARSING ERROR] ${errorMessage}`);
-        return msgParts.join('');
-    }
+const rolePermissionsSchema = new Schema({
+    [PermissionTypes.BOOKMARKS]: {
+        [Permissions.USE]: { type: Boolean },
+    },
+    [PermissionTypes.PROMPTS]: {
+        [Permissions.SHARED_GLOBAL]: { type: Boolean },
+        [Permissions.USE]: { type: Boolean },
+        [Permissions.CREATE]: { type: Boolean },
+    },
+    [PermissionTypes.MEMORIES]: {
+        [Permissions.USE]: { type: Boolean },
+        [Permissions.CREATE]: { type: Boolean },
+        [Permissions.UPDATE]: { type: Boolean },
+        [Permissions.READ]: { type: Boolean },
+        [Permissions.OPT_OUT]: { type: Boolean },
+    },
+    [PermissionTypes.AGENTS]: {
+        [Permissions.SHARED_GLOBAL]: { type: Boolean },
+        [Permissions.USE]: { type: Boolean },
+        [Permissions.CREATE]: { type: Boolean },
+    },
+    [PermissionTypes.MULTI_CONVO]: {
+        [Permissions.USE]: { type: Boolean },
+    },
+    [PermissionTypes.TEMPORARY_CHAT]: {
+        [Permissions.USE]: { type: Boolean },
+    },
+    [PermissionTypes.RUN_CODE]: {
+        [Permissions.USE]: { type: Boolean },
+    },
+    [PermissionTypes.WEB_SEARCH]: {
+        [Permissions.USE]: { type: Boolean },
+    },
+    [PermissionTypes.PEOPLE_PICKER]: {
+        [Permissions.VIEW_USERS]: { type: Boolean },
+        [Permissions.VIEW_GROUPS]: { type: Boolean },
+        [Permissions.VIEW_ROLES]: { type: Boolean },
+    },
+    [PermissionTypes.MARKETPLACE]: {
+        [Permissions.USE]: { type: Boolean },
+    },
+    [PermissionTypes.FILE_SEARCH]: {
+        [Permissions.USE]: { type: Boolean },
+    },
+    [PermissionTypes.FILE_CITATIONS]: {
+        [Permissions.USE]: { type: Boolean },
+    },
+}, { _id: false });
+const roleSchema = new Schema({
+    name: { type: String, required: true, unique: true, index: true },
+    permissions: {
+        type: rolePermissionsSchema,
+    },
+});
+
+const sessionSchema = new Schema({
+    refreshTokenHash: {
+        type: String,
+        required: true,
+    },
+    expiration: {
+        type: Date,
+        required: true,
+        expires: 0,
+    },
+    user: {
+        type: mongoose.Schema.Types.ObjectId,
+        ref: 'User',
+        required: true,
+    },
+});
+
+const shareSchema = new Schema({
+    conversationId: {
+        type: String,
+        required: true,
+    },
+    title: {
+        type: String,
+        index: true,
+    },
+    user: {
+        type: String,
+        index: true,
+    },
+    messages: [{ type: mongoose.Schema.Types.ObjectId, ref: 'Message' }],
+    shareId: {
+        type: String,
+        index: true,
+    },
+    targetMessageId: {
+        type: String,
+        required: false,
+        index: true,
+    },
+    isPublic: {
+        type: Boolean,
+        default: true,
+    },
+}, { timestamps: true });
+shareSchema.index({ conversationId: 1, user: 1, targetMessageId: 1 });
+
+const tokenSchema = new Schema({
+    userId: {
+        type: Schema.Types.ObjectId,
+        required: true,
+        ref: 'user',
+    },
+    email: {
+        type: String,
+    },
+    type: {
+        type: String,
+    },
+    identifier: {
+        type: String,
+    },
+    token: {
+        type: String,
+        required: true,
+    },
+    createdAt: {
+        type: Date,
+        required: true,
+        default: Date.now,
+    },
+    expiresAt: {
+        type: Date,
+        required: true,
+    },
+    metadata: {
+        type: Map,
+        of: Schema.Types.Mixed,
+    },
 });
-/**
- * Truncates long string values in JSON log objects.
- * Prevents outputting extremely long values (e.g., base64, blobs).
- */
-const jsonTruncateFormat = winston.format((info) => {
-    const truncateLongStrings = (str, maxLength) => str.length > maxLength ? str.substring(0, maxLength) + '...' : str;
-    const seen = new WeakSet();
-    const truncateObject = (obj) => {
-        if (typeof obj !== 'object' || obj === null) {
-            return obj;
-        }
-        // Handle circular references - now with proper object type
-        if (seen.has(obj)) {
-            return '[Circular]';
-        }
-        seen.add(obj);
-        if (Array.isArray(obj)) {
-            return obj.map((item) => truncateObject(item));
-        }
-        // We know this is an object at this point
-        const objectRecord = obj;
-        const newObj = {};
-        Object.entries(objectRecord).forEach(([key, value]) => {
-            if (typeof value === 'string') {
-                newObj[key] = truncateLongStrings(value, CONSOLE_JSON_STRING_LENGTH);
-            }
-            else {
-                newObj[key] = truncateObject(value);
-            }
-        });
-        return newObj;
-    };
-    return truncateObject(info);
+tokenSchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 });
+
+const toolCallSchema = new Schema({
+    conversationId: {
+        type: String,
+        required: true,
+    },
+    messageId: {
+        type: String,
+        required: true,
+    },
+    toolId: {
+        type: String,
+        required: true,
+    },
+    user: {
+        type: mongoose.Schema.Types.ObjectId,
+        ref: 'User',
+        required: true,
+    },
+    result: {
+        type: mongoose.Schema.Types.Mixed,
+    },
+    attachments: {
+        type: mongoose.Schema.Types.Mixed,
+    },
+    blockIndex: {
+        type: Number,
+    },
+    partIndex: {
+        type: Number,
+    },
+}, { timestamps: true });
+toolCallSchema.index({ messageId: 1, user: 1 });
+toolCallSchema.index({ conversationId: 1, user: 1 });
+
+const transactionSchema = new Schema({
+    user: {
+        type: mongoose.Schema.Types.ObjectId,
+        ref: 'User',
+        index: true,
+        required: true,
+    },
+    conversationId: {
+        type: String,
+        ref: 'Conversation',
+        index: true,
+    },
+    tokenType: {
+        type: String,
+        enum: ['prompt', 'completion', 'credits'],
+        required: true,
+    },
+    model: {
+        type: String,
+    },
+    context: {
+        type: String,
+    },
+    valueKey: {
+        type: String,
+    },
+    rate: Number,
+    rawAmount: Number,
+    tokenValue: Number,
+    inputTokens: { type: Number },
+    writeTokens: { type: Number },
+    readTokens: { type: Number },
+}, {
+    timestamps: true,
 });
 
-/**
- * Determine the log directory in a cross-compatible way.
- * Priority:
- * 1. LIBRECHAT_LOG_DIR environment variable
- * 2. If running within LibreChat monorepo (when cwd ends with /api), use api/logs
- * 3. If api/logs exists relative to cwd, use that (for running from project root)
- * 4. Otherwise, use logs directory relative to process.cwd()
- *
- * This avoids using __dirname which is not available in ESM modules
- */
-const getLogDirectory = () => {
-    if (process.env.LIBRECHAT_LOG_DIR) {
-        return process.env.LIBRECHAT_LOG_DIR;
-    }
-    const cwd = process.cwd();
-    // Check if we're running from within the api directory
-    if (cwd.endsWith('/api') || cwd.endsWith('\\api')) {
-        return path.join(cwd, 'logs');
-    }
-    // Check if api/logs exists relative to current directory (running from project root)
-    // We'll just use the path and let the file system create it if needed
-    const apiLogsPath = path.join(cwd, 'api', 'logs');
-    // For LibreChat project structure, use api/logs
-    // For external consumers, they should set LIBRECHAT_LOG_DIR
-    if (cwd.includes('LibreChat')) {
-        return apiLogsPath;
-    }
-    // Default to logs directory relative to current working directory
-    return path.join(cwd, 'logs');
-};
+// Session sub-schema
+const SessionSchema = new Schema({
+    refreshToken: {
+        type: String,
+        default: '',
+    },
+}, { _id: false });
+// Backup code sub-schema
+const BackupCodeSchema = new Schema({
+    codeHash: { type: String, required: true },
+    used: { type: Boolean, default: false },
+    usedAt: { type: Date, default: null },
+}, { _id: false });
+const userSchema = new Schema({
+    name: {
+        type: String,
+    },
+    username: {
+        type: String,
+        lowercase: true,
+        default: '',
+    },
+    email: {
+        type: String,
+        required: [true, "can't be blank"],
+        lowercase: true,
+        unique: true,
+        match: [/\S+@\S+\.\S+/, 'is invalid'],
+        index: true,
+    },
+    emailVerified: {
+        type: Boolean,
+        required: true,
+        default: false,
+    },
+    password: {
+        type: String,
+        trim: true,
+        minlength: 8,
+        maxlength: 128,
+        select: false,
+    },
+    avatar: {
+        type: String,
+        required: false,
+    },
+    provider: {
+        type: String,
+        required: true,
+        default: 'local',
+    },
+    role: {
+        type: String,
+        default: SystemRoles.USER,
+    },
+    googleId: {
+        type: String,
+        unique: true,
+        sparse: true,
+    },
+    facebookId: {
+        type: String,
+        unique: true,
+        sparse: true,
+    },
+    openidId: {
+        type: String,
+        unique: true,
+        sparse: true,
+    },
+    samlId: {
+        type: String,
+        unique: true,
+        sparse: true,
+    },
+    ldapId: {
+        type: String,
+        unique: true,
+        sparse: true,
+    },
+    githubId: {
+        type: String,
+        unique: true,
+        sparse: true,
+    },
+    discordId: {
+        type: String,
+        unique: true,
+        sparse: true,
+    },
+    appleId: {
+        type: String,
+        unique: true,
+        sparse: true,
+    },
+    plugins: {
+        type: Array,
+    },
+    twoFactorEnabled: {
+        type: Boolean,
+        default: false,
+    },
+    totpSecret: {
+        type: String,
+        select: false,
+    },
+    backupCodes: {
+        type: [BackupCodeSchema],
+        select: false,
+    },
+    refreshToken: {
+        type: [SessionSchema],
+    },
+    expiresAt: {
+        type: Date,
+        expires: 604800, // 7 days in seconds
+    },
+    termsAccepted: {
+        type: Boolean,
+        default: false,
+    },
+    personalization: {
+        type: {
+            memories: {
+                type: Boolean,
+                default: true,
+            },
+        },
+        default: {},
+    },
+    /** Field for external source identification (for consistency with TPrincipal schema) */
+    idOnTheSource: {
+        type: String,
+        sparse: true,
+    },
+}, { timestamps: true });
 
-const logDir$1 = getLogDirectory();
-const { NODE_ENV: NODE_ENV$1, DEBUG_LOGGING: DEBUG_LOGGING$1, CONSOLE_JSON, DEBUG_CONSOLE } = process.env;
-const useConsoleJson = typeof CONSOLE_JSON === 'string' && CONSOLE_JSON.toLowerCase() === 'true';
-const useDebugConsole = typeof DEBUG_CONSOLE === 'string' && DEBUG_CONSOLE.toLowerCase() === 'true';
-const useDebugLogging$1 = typeof DEBUG_LOGGING$1 === 'string' && DEBUG_LOGGING$1.toLowerCase() === 'true';
-const levels$1 = {
-    error: 0,
-    warn: 1,
-    info: 2,
-    http: 3,
-    verbose: 4,
-    debug: 5,
-    activity: 6,
-    silly: 7,
-};
-winston.addColors({
-    info: 'green',
-    warn: 'italic yellow',
-    error: 'red',
-    debug: 'blue',
+const MemoryEntrySchema = new Schema({
+    userId: {
+        type: Schema.Types.ObjectId,
+        ref: 'User',
+        index: true,
+        required: true,
+    },
+    key: {
+        type: String,
+        required: true,
+        validate: {
+            validator: (v) => /^[a-z_]+$/.test(v),
+            message: 'Key must only contain lowercase letters and underscores',
+        },
+    },
+    value: {
+        type: String,
+        required: true,
+    },
+    tokenCount: {
+        type: Number,
+        default: 0,
+    },
+    updated_at: {
+        type: Date,
+        default: Date.now,
+    },
 });
-const level$1 = () => {
-    const env = NODE_ENV$1 || 'development';
-    return env === 'development' ? 'debug' : 'warn';
-};
-const fileFormat$1 = winston.format.combine(redactFormat(), winston.format.timestamp({ format: () => new Date().toISOString() }), winston.format.errors({ stack: true }), winston.format.splat());
-const transports$1 = [
-    new winston.transports.DailyRotateFile({
-        level: 'error',
-        filename: `${logDir$1}/error-%DATE%.log`,
-        datePattern: 'YYYY-MM-DD',
-        zippedArchive: true,
-        maxSize: '20m',
-        maxFiles: '14d',
-        format: winston.format.combine(fileFormat$1, winston.format.json()),
-    }),
-];
-if (useDebugLogging$1) {
-    transports$1.push(new winston.transports.DailyRotateFile({
-        level: 'debug',
-        filename: `${logDir$1}/debug-%DATE%.log`,
-        datePattern: 'YYYY-MM-DD',
-        zippedArchive: true,
-        maxSize: '20m',
-        maxFiles: '14d',
-        format: winston.format.combine(fileFormat$1, debugTraverse),
-    }));
-}
-const consoleFormat$1 = winston.format.combine(redactFormat(), winston.format.colorize({ all: true }), winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.printf((info) => {
-    const message = `${info.timestamp} ${info.level}: ${info.message}`;
-    return info.level.includes('error') ? redactMessage(message) : message;
-}));
-let consoleLogLevel = 'info';
-if (useDebugConsole) {
-    consoleLogLevel = 'debug';
-}
-// Add console transport
-if (useDebugConsole) {
-    transports$1.push(new winston.transports.Console({
-        level: consoleLogLevel,
-        format: useConsoleJson
-            ? winston.format.combine(fileFormat$1, jsonTruncateFormat(), winston.format.json())
-            : winston.format.combine(fileFormat$1, debugTraverse),
-    }));
-}
-else if (useConsoleJson) {
-    transports$1.push(new winston.transports.Console({
-        level: consoleLogLevel,
-        format: winston.format.combine(fileFormat$1, jsonTruncateFormat(), winston.format.json()),
-    }));
-}
-else {
-    transports$1.push(new winston.transports.Console({
-        level: consoleLogLevel,
-        format: consoleFormat$1,
-    }));
-}
-// Create logger
-const logger$1 = winston.createLogger({
-    level: level$1(),
-    levels: levels$1,
-    transports: transports$1,
+
+const groupSchema = new Schema({
+    name: {
+        type: String,
+        required: true,
+        index: true,
+    },
+    description: {
+        type: String,
+        required: false,
+    },
+    email: {
+        type: String,
+        required: false,
+        index: true,
+    },
+    avatar: {
+        type: String,
+        required: false,
+    },
+    memberIds: [
+        {
+            type: String,
+            required: false,
+        },
+    ],
+    source: {
+        type: String,
+        enum: ['local', 'entra'],
+        default: 'local',
+    },
+    /** External ID (e.g., Entra ID) */
+    idOnTheSource: {
+        type: String,
+        sparse: true,
+        index: true,
+        required: function () {
+            return this.source !== 'local';
+        },
+    },
+}, { timestamps: true });
+groupSchema.index({ idOnTheSource: 1, source: 1 }, {
+    unique: true,
+    partialFilterExpression: { idOnTheSource: { $exists: true } },
 });
+groupSchema.index({ memberIds: 1 });
 
 /**
  * Checks if the connected MongoDB deployment supports transactions
@@ -3058,7 +3561,11 @@ function createTokenMethods(mongoose) {
     async function updateToken(query, updateData) {
         try {
             const Token = mongoose.models.Token;
-            return await Token.findOneAndUpdate(query, updateData, { new: true });
+            const dataToUpdate = { ...updateData };
+            if ((updateData === null || updateData === void 0 ? void 0 : updateData.expiresIn) !== undefined) {
+                dataToUpdate.expiresAt = new Date(Date.now() + updateData.expiresIn * 1000);
+            }
+            return await Token.findOneAndUpdate(query, dataToUpdate, { new: true });
         }
         catch (error) {
             logger$1.debug('An error occurred while updating token:', error);
@@ -3067,6 +3574,7 @@ function createTokenMethods(mongoose) {
     }
     /**
      * Deletes all Token documents that match the provided token, user ID, or email.
+     * Email is automatically normalized to lowercase for case-insensitive matching.
      */
     async function deleteTokens(query) {
         try {
@@ -3079,7 +3587,7 @@ function createTokenMethods(mongoose) {
                 conditions.push({ token: query.token });
             }
             if (query.email !== undefined) {
-                conditions.push({ email: query.email });
+                conditions.push({ email: query.email.trim().toLowerCase() });
             }
             if (query.identifier !== undefined) {
                 conditions.push({ identifier: query.identifier });
@@ -3101,6 +3609,7 @@ function createTokenMethods(mongoose) {
     }
     /**
      * Finds a Token document that matches the provided query.
+     * Email is automatically normalized to lowercase for case-insensitive matching.
      */
     async function findToken(query, options) {
         try {
@@ -3113,7 +3622,7 @@ function createTokenMethods(mongoose) {
                 conditions.push({ token: query.token });
             }
             if (query.email) {
-                conditions.push({ email: query.email });
+                conditions.push({ email: query.email.trim().toLowerCase() });
             }
             if (query.identifier) {
                 conditions.push({ identifier: query.identifier });
@@ -3180,12 +3689,33 @@ function createRoleMethods(mongoose) {
 
 /** Factory function that takes mongoose instance and returns the methods */
 function createUserMethods(mongoose) {
+    /**
+     * Normalizes email fields in search criteria to lowercase and trimmed.
+     * Handles both direct email fields and $or arrays containing email conditions.
+     */
+    function normalizeEmailInCriteria(criteria) {
+        const normalized = { ...criteria };
+        if (typeof normalized.email === 'string') {
+            normalized.email = normalized.email.trim().toLowerCase();
+        }
+        if (Array.isArray(normalized.$or)) {
+            normalized.$or = normalized.$or.map((condition) => {
+                if (typeof condition.email === 'string') {
+                    return { ...condition, email: condition.email.trim().toLowerCase() };
+                }
+                return condition;
+            });
+        }
+        return normalized;
+    }
     /**
      * Search for a single user based on partial data and return matching user document as plain object.
+     * Email fields in searchCriteria are automatically normalized to lowercase for case-insensitive matching.
      */
     async function findUser(searchCriteria, fieldsToSelect) {
         const User = mongoose.models.User;
-        const query = User.findOne(searchCriteria);
+        const normalizedCriteria = normalizeEmailInCriteria(searchCriteria);
+        const query = User.findOne(normalizedCriteria);
         if (fieldsToSelect) {
             query.select(fieldsToSelect);
         }
@@ -4764,6 +5294,68 @@ function anonymizeMessages(messages, newConvoId) {
         };
     });
 }
+/**
+ * Filter messages up to and including the target message (branch-specific)
+ * Similar to getMessagesUpToTargetLevel from fork utilities
+ */
+function getMessagesUpToTarget(messages, targetMessageId) {
+    var _a, _b;
+    if (!messages || messages.length === 0) {
+        return [];
+    }
+    // If only one message and it's the target, return it
+    if (messages.length === 1 && ((_a = messages[0]) === null || _a === void 0 ? void 0 : _a.messageId) === targetMessageId) {
+        return messages;
+    }
+    // Create a map of parentMessageId to children messages
+    const parentToChildrenMap = new Map();
+    for (const message of messages) {
+        const parentId = message.parentMessageId || Constants.NO_PARENT;
+        if (!parentToChildrenMap.has(parentId)) {
+            parentToChildrenMap.set(parentId, []);
+        }
+        (_b = parentToChildrenMap.get(parentId)) === null || _b === void 0 ? void 0 : _b.push(message);
+    }
+    // Find the target message
+    const targetMessage = messages.find((msg) => msg.messageId === targetMessageId);
+    if (!targetMessage) {
+        // If target not found, return all messages for backwards compatibility
+        return messages;
+    }
+    const visited = new Set();
+    const rootMessages = parentToChildrenMap.get(Constants.NO_PARENT) || [];
+    let currentLevel = rootMessages.length > 0 ? [...rootMessages] : [targetMessage];
+    const results = new Set(currentLevel);
+    // Check if the target message is at the root level
+    if (currentLevel.some((msg) => msg.messageId === targetMessageId) &&
+        targetMessage.parentMessageId === Constants.NO_PARENT) {
+        return Array.from(results);
+    }
+    // Iterate level by level until the target is found
+    let targetFound = false;
+    while (!targetFound && currentLevel.length > 0) {
+        const nextLevel = [];
+        for (const node of currentLevel) {
+            if (visited.has(node.messageId)) {
+                continue;
+            }
+            visited.add(node.messageId);
+            const children = parentToChildrenMap.get(node.messageId) || [];
+            for (const child of children) {
+                if (visited.has(child.messageId)) {
+                    continue;
+                }
+                nextLevel.push(child);
+                results.add(child);
+                if (child.messageId === targetMessageId) {
+                    targetFound = true;
+                }
+            }
+        }
+        currentLevel = nextLevel;
+    }
+    return Array.from(results);
+}
 /** Factory function that takes mongoose instance and returns the methods */
 function createShareMethods(mongoose) {
     /**
@@ -4782,6 +5374,11 @@ function createShareMethods(mongoose) {
             if (!(share === null || share === void 0 ? void 0 : share.conversationId) || !share.isPublic) {
                 return null;
             }
+            /** Filtered messages based on targetMessageId if present (branch-specific sharing) */
+            let messagesToShare = share.messages;
+            if (share.targetMessageId) {
+                messagesToShare = getMessagesUpToTarget(share.messages, share.targetMessageId);
+            }
             const newConvoId = anonymizeConvoId(share.conversationId);
             const result = {
                 shareId: share.shareId || shareId,
@@ -4790,7 +5387,7 @@ function createShareMethods(mongoose) {
                 createdAt: share.createdAt,
                 updatedAt: share.updatedAt,
                 conversationId: newConvoId,
-                messages: anonymizeMessages(share.messages, newConvoId),
+                messages: anonymizeMessages(messagesToShare, newConvoId),
             };
             return result;
         }
@@ -4898,10 +5495,34 @@ function createShareMethods(mongoose) {
             throw new ShareServiceError('Error deleting shared links', 'BULK_DELETE_ERROR');
         }
     }
+    /**
+     * Delete shared links by conversation ID
+     */
+    async function deleteConvoSharedLink(user, conversationId) {
+        if (!user || !conversationId) {
+            throw new ShareServiceError('Missing required parameters', 'INVALID_PARAMS');
+        }
+        try {
+            const SharedLink = mongoose.models.SharedLink;
+            const result = await SharedLink.deleteMany({ user, conversationId });
+            return {
+                message: 'Shared links deleted successfully',
+                deletedCount: result.deletedCount,
+            };
+        }
+        catch (error) {
+            logger$1.error('[deleteConvoSharedLink] Error deleting shared links', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+                user,
+                conversationId,
+            });
+            throw new ShareServiceError('Error deleting shared links', 'SHARE_DELETE_ERROR');
+        }
+    }
     /**
      * Create a new shared link for a conversation
      */
-    async function createSharedLink(user, conversationId) {
+    async function createSharedLink(user, conversationId, targetMessageId) {
         if (!user || !conversationId) {
             throw new ShareServiceError('Missing required parameters', 'INVALID_PARAMS');
         }
@@ -4910,7 +5531,12 @@ function createShareMethods(mongoose) {
             const SharedLink = mongoose.models.SharedLink;
             const Conversation = mongoose.models.Conversation;
             const [existingShare, conversationMessages] = await Promise.all([
-                SharedLink.findOne({ conversationId, user, isPublic: true })
+                SharedLink.findOne({
+                    conversationId,
+                    user,
+                    isPublic: true,
+                    ...(targetMessageId && { targetMessageId }),
+                })
                     .select('-_id -__v -user')
                     .lean(),
                 Message.find({ conversationId, user }).sort({ createdAt: 1 }).lean(),
@@ -4919,11 +5545,16 @@ function createShareMethods(mongoose) {
                 logger$1.error('[createSharedLink] Share already exists', {
                     user,
                     conversationId,
+                    targetMessageId,
                 });
                 throw new ShareServiceError('Share already exists', 'SHARE_EXISTS');
             }
             else if (existingShare) {
-                await SharedLink.deleteOne({ conversationId, user });
+                await SharedLink.deleteOne({
+                    conversationId,
+                    user,
+                    ...(targetMessageId && { targetMessageId }),
+                });
             }
             const conversation = (await Conversation.findOne({ conversationId, user }).lean());
             // Check if user owns the conversation
@@ -4942,6 +5573,7 @@ function createShareMethods(mongoose) {
                 messages: conversationMessages,
                 title,
                 user,
+                ...(targetMessageId && { targetMessageId }),
             });
             return { shareId, conversationId };
         }
@@ -4953,6 +5585,7 @@ function createShareMethods(mongoose) {
                 error: error instanceof Error ? error.message : 'Unknown error',
                 user,
                 conversationId,
+                targetMessageId,
             });
             throw new ShareServiceError('Error creating shared link', 'SHARE_CREATE_ERROR');
         }
@@ -5065,6 +5698,7 @@ function createShareMethods(mongoose) {
         deleteSharedLink,
         getSharedMessages,
         deleteAllSharedLinks,
+        deleteConvoSharedLink,
     };
 }
 
@@ -5087,5 +5721,5 @@ function createMethods(mongoose) {
     };
 }
 
-export { RoleBits, Action as actionSchema, agentCategorySchema, agentSchema, assistantSchema, balanceSchema, bannerSchema, categoriesSchema, conversationTag as conversationTagSchema, convoSchema, createMethods, createModels, file as fileSchema, getTransactionSupport, groupSchema, hashToken, keySchema, logger$1 as logger, logger as meiliLogger, MemoryEntrySchema as memorySchema, messageSchema, pluginAuthSchema, presetSchema, projectSchema, promptGroupSchema, promptSchema, roleSchema, sessionSchema, shareSchema, signPayload, supportsTransactions, tokenSchema, toolCallSchema, transactionSchema, userSchema };
+export { AppService, RoleBits, Action as actionSchema, agentCategorySchema, agentSchema, agentsConfigSetup, assistantSchema, balanceSchema, bannerSchema, categoriesSchema, conversationTag as conversationTagSchema, convoSchema, createMethods, createModels, file as fileSchema, getTransactionSupport, getWebSearchKeys, groupSchema, hashToken, keySchema, loadDefaultInterface, loadTurnstileConfig, loadWebSearchConfig, logger$1 as logger, logger as meiliLogger, MemoryEntrySchema as memorySchema, messageSchema, pluginAuthSchema, presetSchema, processModelSpecs, projectSchema, promptGroupSchema, promptSchema, roleSchema, sessionSchema, shareSchema, signPayload, supportsTransactions, tokenSchema, toolCallSchema, transactionSchema, userSchema, webSearchAuth, webSearchKeys };
 //# sourceMappingURL=index.es.js.map