@librechat/data-schemas 0.0.40 → 0.0.43

package/dist/types/admin/capabilities.d.ts

@@ -0,0 +1,73 @@
+import { ResourceType } from 'librechat-data-provider';
+import type { BaseSystemCapability, SystemCapability, ConfigSection, CapabilityCategory } from '~/types/admin';
+/**
+ * The canonical set of base system capabilities.
+ *
+ * These are used by the admin panel and LibreChat API to gate access to
+ * admin features. Config-section-derived capabilities (e.g.
+ * `manage:configs:endpoints`) are built on top of these where the
+ * configSchema is available.
+ */
+export declare const SystemCapabilities: {
+    readonly ACCESS_ADMIN: "access:admin";
+    readonly READ_USERS: "read:users";
+    readonly MANAGE_USERS: "manage:users";
+    readonly READ_GROUPS: "read:groups";
+    readonly MANAGE_GROUPS: "manage:groups";
+    readonly READ_ROLES: "read:roles";
+    readonly MANAGE_ROLES: "manage:roles";
+    readonly READ_CONFIGS: "read:configs";
+    readonly MANAGE_CONFIGS: "manage:configs";
+    readonly ASSIGN_CONFIGS: "assign:configs";
+    readonly READ_USAGE: "read:usage";
+    readonly READ_AGENTS: "read:agents";
+    readonly MANAGE_AGENTS: "manage:agents";
+    readonly MANAGE_MCP_SERVERS: "manage:mcpservers";
+    readonly READ_PROMPTS: "read:prompts";
+    readonly MANAGE_PROMPTS: "manage:prompts";
+    /** Reserved — not yet enforced by any middleware. */
+    readonly READ_ASSISTANTS: "read:assistants";
+    readonly MANAGE_ASSISTANTS: "manage:assistants";
+};
+/**
+ * Capabilities that are implied by holding a broader capability.
+ * e.g. `MANAGE_USERS` implies `READ_USERS`.
+ */
+export declare const CapabilityImplications: Partial<Record<BaseSystemCapability, BaseSystemCapability[]>>;
+/**
+ * Check whether a set of held capabilities satisfies a required capability,
+ * accounting for the manage→read implication hierarchy.
+ */
+export declare function hasImpliedCapability(held: string[], required: string): boolean;
+/**
+ * Given a set of directly-held capabilities, compute the full set including
+ * all implied capabilities.
+ */
+export declare function expandImplications(directCaps: string[]): string[];
+/**
+ * Maps each ACL ResourceType to the SystemCapability that grants
+ * unrestricted management access. Typed as `Record<ResourceType, …>`
+ * so adding a new ResourceType variant causes a compile error until a
+ * capability is assigned here.
+ */
+export declare const ResourceCapabilityMap: Record<ResourceType, SystemCapability>;
+/**
+ * Derives a section-level config management capability from a configSchema key.
+ * @example configCapability('endpoints') → 'manage:configs:endpoints'
+ *
+ * TODO: Section-level config capabilities are scaffolded but not yet active.
+ * To activate delegated config management:
+ *  1. Expose POST/DELETE /api/admin/grants endpoints (wiring grantCapability/revokeCapability)
+ *  2. Seed section-specific grants for delegated admin roles via those endpoints
+ *  3. Guard config write handlers with hasConfigCapability(user, section)
+ */
+export declare function configCapability(section: ConfigSection): `manage:configs:${ConfigSection}`;
+/**
+ * Derives a section-level config read capability from a configSchema key.
+ * @example readConfigCapability('endpoints') → 'read:configs:endpoints'
+ */
+export declare function readConfigCapability(section: ConfigSection): `read:configs:${ConfigSection}`;
+/** Reserved principalId for the DB base config (overrides YAML defaults). */
+export declare const BASE_CONFIG_PRINCIPAL_ID = "__base__";
+/** Pre-defined UI categories for grouping capabilities in the admin panel. */
+export declare const CAPABILITY_CATEGORIES: CapabilityCategory[];

package/dist/types/admin/index.d.ts

@@ -0,0 +1 @@
+export * from './capabilities';

package/dist/types/app/index.d.ts

@@ -5,3 +5,4 @@ export * from './specs';
 export * from './turnstile';
 export * from './vertex';
 export * from './web';
+export * from './resolution';

package/dist/types/app/resolution.d.ts

@@ -0,0 +1,13 @@
+import type { AppConfig } from '~/types';
+import type { IConfig } from '~/types';
+/**
+ * Merge DB config overrides into a base AppConfig.
+ *
+ * Configs are sorted by priority ascending (lowest first, highest wins).
+ * Each config's `overrides` is deep-merged into the base config in order.
+ *
+ * @param baseConfig - The base AppConfig from AppService (YAML-derived, cached)
+ * @param configs - Array of Config documents from the DB
+ * @returns Merged AppConfig with overrides applied
+ */
+export declare function mergeConfigOverrides(baseConfig: AppConfig, configs: IConfig[]): AppConfig;

package/dist/types/config/tenantContext.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="node" />
+import { AsyncLocalStorage } from 'async_hooks';
+export interface TenantContext {
+    tenantId?: string;
+}
+/** Sentinel value for deliberate cross-tenant system operations */
+export declare const SYSTEM_TENANT_ID = "__SYSTEM__";
+/**
+ * AsyncLocalStorage instance for propagating tenant context.
+ * Callbacks passed to `tenantStorage.run()` must be `async` for the context to propagate
+ * through Mongoose query execution. Sync callbacks returning a Mongoose thenable will lose context.
+ */
+export declare const tenantStorage: AsyncLocalStorage<TenantContext>;
+/** Returns the current tenant ID from async context, or undefined if none is set */
+export declare function getTenantId(): string | undefined;
+/**
+ * Runs a function in an explicit cross-tenant system context (bypasses tenant filtering).
+ * The callback MUST be async — sync callbacks returning Mongoose thenables will lose context.
+ */
+export declare function runAsSystem<T>(fn: () => Promise<T>): Promise<T>;

package/dist/types/index.d.ts

@@ -1,11 +1,15 @@
 export * from './app';
+export * from './admin';
 export * from './common';
 export * from './crypto';
 export * from './schema';
 export * from './utils';
 export { createModels } from './models';
-export { createMethods, DEFAULT_REFRESH_TOKEN_EXPIRY, DEFAULT_SESSION_EXPIRY } from './methods';
+export { createMethods, DEFAULT_REFRESH_TOKEN_EXPIRY, DEFAULT_SESSION_EXPIRY, tokenValues, cacheTokenValues, premiumTokenValues, defaultRate, } from './methods';
 export type * from './types';
 export type * from './methods';
 export { default as logger } from './config/winston';
 export { default as meiliLogger } from './config/meiliLogger';
+export { tenantStorage, getTenantId, runAsSystem, SYSTEM_TENANT_ID } from './config/tenantContext';
+export type { TenantContext } from './config/tenantContext';
+export { dropSupersededTenantIndexes } from './migrations';

package/dist/types/methods/aclEntry.d.ts

@@ -24,7 +24,7 @@
 /// <reference types="mongoose/types/inferschematype" />
 /// <reference types="mongoose/types/inferrawdoctype" />
 import { Types } from 'mongoose';
-import type { DeleteResult, ClientSession } from 'mongoose';
+import type { AnyBulkWriteOperation, ClientSession, PipelineStage, DeleteResult } from 'mongoose';
 import type { IAclEntry } from '~/types';
 export declare function createAclEntryMethods(mongoose: typeof import('mongoose')): {
     findEntriesByPrincipal: (principalType: string, principalId: string | Types.ObjectId, resourceType?: string) => Promise<IAclEntry[]>;
@@ -52,5 +52,14 @@ export declare function createAclEntryMethods(mongoose: typeof import('mongoose'
         principalType: string;
         principalId?: string | Types.ObjectId;
     }>, resourceType: string, requiredPermBit: number) => Promise<Types.ObjectId[]>;
+    deleteAclEntries: (filter: Record<string, unknown>, options?: {
+        session?: ClientSession;
+    }) => Promise<DeleteResult>;
+    bulkWriteAclEntries: (ops: AnyBulkWriteOperation<IAclEntry>[], options?: {
+        session?: ClientSession;
+    }) => Promise<import("mongodb").BulkWriteResult>;
+    findPublicResourceIds: (resourceType: string, requiredPermissions: number) => Promise<Types.ObjectId[]>;
+    aggregateAclEntries: (pipeline: PipelineStage[]) => Promise<any[]>;
+    getSoleOwnedResourceIds: (userObjectId: Types.ObjectId, resourceTypes: string | string[]) => Promise<Types.ObjectId[]>;
 };
 export type AclEntryMethods = ReturnType<typeof createAclEntryMethods>;

package/dist/types/methods/action.d.ts

@@ -0,0 +1,34 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import type { FilterQuery } from 'mongoose';
+import type { IAction } from '~/types';
+export declare function createActionMethods(mongoose: typeof import('mongoose')): {
+    getActions: (searchParams: FilterQuery<IAction>, includeSensitive?: boolean) => Promise<IAction[]>;
+    updateAction: (searchParams: FilterQuery<IAction>, updateData: Partial<IAction>) => Promise<IAction | null>;
+    deleteAction: (searchParams: FilterQuery<IAction>) => Promise<IAction | null>;
+    deleteActions: (searchParams: FilterQuery<IAction>) => Promise<number>;
+};
+export type ActionMethods = ReturnType<typeof createActionMethods>;

package/dist/types/methods/agent.d.ts

@@ -0,0 +1,89 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import type { FilterQuery, Types } from 'mongoose';
+import type { IAgent } from '~/types';
+export interface AgentDeps {
+    /** Removes all ACL permissions for a resource. Injected from PermissionService. */
+    removeAllPermissions: (params: {
+        resourceType: string;
+        resourceId: unknown;
+    }) => Promise<void>;
+    /** Gets actions. Created by createActionMethods. */
+    getActions: (searchParams: FilterQuery<unknown>, includeSensitive?: boolean) => Promise<unknown[]>;
+    /** Returns resource IDs solely owned by the given user. From createAclEntryMethods. */
+    getSoleOwnedResourceIds: (userObjectId: Types.ObjectId, resourceTypes: string | string[]) => Promise<Types.ObjectId[]>;
+}
+/**
+ * Generates a hash of action metadata for version comparison.
+ */
+declare function generateActionMetadataHash(actionIds: string[] | null | undefined, actions: Array<{
+    action_id: string;
+    metadata: Record<string, unknown> | null;
+}>): Promise<string>;
+export declare function createAgentMethods(mongoose: typeof import('mongoose'), deps: AgentDeps): {
+    getAgent: (searchParameter: FilterQuery<IAgent>) => Promise<IAgent | null>;
+    getAgents: (searchParameter: FilterQuery<IAgent>) => Promise<IAgent[]>;
+    createAgent: (agentData: Record<string, unknown>) => Promise<IAgent>;
+    updateAgent: (searchParameter: FilterQuery<IAgent>, updateData: Record<string, unknown>, options?: {
+        updatingUserId?: string | null;
+        forceVersion?: boolean;
+        skipVersioning?: boolean;
+    }) => Promise<IAgent | null>;
+    deleteAgent: (searchParameter: FilterQuery<IAgent>) => Promise<IAgent | null>;
+    deleteUserAgents: (userId: string) => Promise<void>;
+    revertAgentVersion: (searchParameter: FilterQuery<IAgent>, versionIndex: number) => Promise<IAgent>;
+    countPromotedAgents: () => Promise<number>;
+    addAgentResourceFile: ({ agent_id, tool_resource, file_id, updatingUserId, }: {
+        agent_id: string;
+        tool_resource: string;
+        file_id: string;
+        updatingUserId?: string | undefined;
+    }) => Promise<IAgent>;
+    getListAgentsByAccess: ({ accessibleIds, otherParams, limit, after, }: {
+        accessibleIds?: Types.ObjectId[] | undefined;
+        otherParams?: Record<string, unknown> | undefined;
+        limit?: number | null | undefined;
+        after?: string | null | undefined;
+    }) => Promise<{
+        object: string;
+        data: Array<Record<string, unknown>>;
+        first_id: string | null;
+        last_id: string | null;
+        has_more: boolean;
+        after: string | null;
+    }>;
+    removeAgentResourceFiles: ({ agent_id, files, }: {
+        agent_id: string;
+        files: Array<{
+            tool_resource: string;
+            file_id: string;
+        }>;
+    }) => Promise<IAgent>;
+    generateActionMetadataHash: typeof generateActionMetadataHash;
+    removeAgentFromUserFavorites: (resourceId: string, userIds: string[]) => Promise<void>;
+};
+export type AgentMethods = ReturnType<typeof createAgentMethods>;
+export {};

package/dist/types/methods/assistant.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import type { FilterQuery } from 'mongoose';
+import type { IAssistant } from '~/types';
+export declare function createAssistantMethods(mongoose: typeof import('mongoose')): {
+    updateAssistantDoc: (searchParams: FilterQuery<IAssistant>, updateData: Partial<IAssistant>) => Promise<IAssistant | null>;
+    deleteAssistant: (searchParams: FilterQuery<IAssistant>) => Promise<(import("mongoose").Document<unknown, {}, IAssistant> & IAssistant & Required<{
+        _id: unknown;
+    }> & {
+        __v: number;
+    }) | null>;
+    deleteAssistants: (searchParams: FilterQuery<IAssistant>) => Promise<number>;
+    getAssistants: (searchParams: FilterQuery<IAssistant>, select?: string | Record<string, number> | null) => Promise<IAssistant[]>;
+    getAssistant: (searchParams: FilterQuery<IAssistant>) => Promise<IAssistant | null>;
+};
+export type AssistantMethods = ReturnType<typeof createAssistantMethods>;

package/dist/types/methods/banner.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import type { IBanner, IUser } from '~/types';
+export declare function createBannerMethods(mongoose: typeof import('mongoose')): {
+    getBanner: (user?: IUser | null) => Promise<IBanner | null>;
+};
+export type BannerMethods = ReturnType<typeof createBannerMethods>;

package/dist/types/methods/categories.d.ts

@@ -0,0 +1,34 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+export type CategoryOption = {
+    label: string;
+    value: string;
+};
+export declare function createCategoriesMethods(_mongoose: typeof import('mongoose')): {
+    getCategories: () => Promise<CategoryOption[]>;
+};
+export type CategoriesMethods = ReturnType<typeof createCategoriesMethods>;

package/dist/types/methods/config.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import { Types } from 'mongoose';
+import type { ClientSession } from 'mongoose';
+import type { IConfig } from '~/types';
+export declare function createConfigMethods(mongoose: typeof import('mongoose')): {
+    findConfigByPrincipal: (principalType: PrincipalType, principalId: string | Types.ObjectId, session?: ClientSession) => Promise<IConfig | null>;
+    getApplicableConfigs: (principals?: Array<{
+        principalType: string;
+        principalId?: string | Types.ObjectId;
+    }>, session?: ClientSession) => Promise<IConfig[]>;
+    upsertConfig: (principalType: PrincipalType, principalId: string | Types.ObjectId, principalModel: PrincipalModel, overrides: Record<string, unknown>, priority: number, session?: ClientSession) => Promise<IConfig | null>;
+    deleteConfig: (principalType: PrincipalType, principalId: string | Types.ObjectId, session?: ClientSession) => Promise<IConfig | null>;
+    toggleConfigActive: (principalType: PrincipalType, principalId: string | Types.ObjectId, isActive: boolean, session?: ClientSession) => Promise<IConfig | null>;
+};
+export type ConfigMethods = ReturnType<typeof createConfigMethods>;

package/dist/types/methods/conversation.d.ts

@@ -0,0 +1,82 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import type { FilterQuery } from 'mongoose';
+import type { AppConfig, IConversation } from '~/types';
+import type { MessageMethods } from './message';
+import type { DeleteResult } from 'mongoose';
+export interface ConversationMethods {
+    getConvoFiles(conversationId: string): Promise<string[]>;
+    searchConversation(conversationId: string): Promise<IConversation | null>;
+    deleteNullOrEmptyConversations(): Promise<{
+        conversations: {
+            deletedCount?: number;
+        };
+        messages: {
+            deletedCount?: number;
+        };
+    }>;
+    saveConvo(ctx: {
+        userId: string;
+        isTemporary?: boolean;
+        interfaceConfig?: AppConfig['interfaceConfig'];
+    }, data: {
+        conversationId: string;
+        newConversationId?: string;
+        [key: string]: unknown;
+    }, metadata?: {
+        context?: string;
+        unsetFields?: Record<string, number>;
+        noUpsert?: boolean;
+    }): Promise<IConversation | {
+        message: string;
+    } | null>;
+    bulkSaveConvos(conversations: Array<Record<string, unknown>>): Promise<unknown>;
+    getConvosByCursor(user: string, options?: {
+        cursor?: string | null;
+        limit?: number;
+        isArchived?: boolean;
+        tags?: string[];
+        search?: string;
+        sortBy?: string;
+        sortDirection?: string;
+    }): Promise<{
+        conversations: IConversation[];
+        nextCursor: string | null;
+    }>;
+    getConvosQueried(user: string, convoIds: Array<{
+        conversationId: string;
+    }> | null, cursor?: string | null, limit?: number): Promise<{
+        conversations: IConversation[];
+        nextCursor: string | null;
+        convoMap: Record<string, unknown>;
+    }>;
+    getConvo(user: string, conversationId: string): Promise<IConversation | null>;
+    getConvoTitle(user: string, conversationId: string): Promise<string | null>;
+    deleteConvos(user: string, filter: FilterQuery<IConversation>): Promise<DeleteResult & {
+        messages: DeleteResult;
+    }>;
+}
+export declare function createConversationMethods(mongoose: typeof import('mongoose'), messageMethods?: Pick<MessageMethods, 'getMessages' | 'deleteMessages'>): ConversationMethods;

package/dist/types/methods/conversationTag.d.ts

@@ -0,0 +1,93 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+export declare function createConversationTagMethods(mongoose: typeof import('mongoose')): {
+    getConversationTags: (user: string) => Promise<(import("mongoose").FlattenMaps<{
+        [x: string]: unknown;
+        user: string;
+        tag: string;
+        description?: string | undefined;
+        position: number;
+        count: number;
+        createdAt?: Date | undefined;
+    }> & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    })[]>;
+    createConversationTag: (user: string, data: {
+        tag: string;
+        description?: string;
+        addToConversation?: boolean;
+        conversationId?: string;
+    }) => Promise<(import("mongoose").FlattenMaps<{
+        [x: string]: unknown;
+        user: string;
+        tag: string;
+        description?: string | undefined;
+        position: number;
+        count: number;
+        createdAt?: Date | undefined;
+    }> & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }) | null>;
+    updateConversationTag: (user: string, oldTag: string, data: {
+        tag?: string;
+        description?: string;
+        position?: number;
+    }) => Promise<(import("mongoose").FlattenMaps<{
+        [x: string]: unknown;
+        user: string;
+        tag: string;
+        description?: string | undefined;
+        position: number;
+        count: number;
+        createdAt?: Date | undefined;
+    }> & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }) | null>;
+    deleteConversationTag: (user: string, tag: string) => Promise<(import("mongoose").FlattenMaps<{
+        [x: string]: unknown;
+        user: string;
+        tag: string;
+        description?: string | undefined;
+        position: number;
+        count: number;
+        createdAt?: Date | undefined;
+    }> & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }) | null>;
+    deleteConversationTags: (filter: Record<string, unknown>) => Promise<number>;
+    bulkIncrementTagCounts: (user: string, tags: string[]) => Promise<void>;
+    updateTagsForConversation: (user: string, conversationId: string, tags: string[]) => Promise<any>;
+};
+export type ConversationTagMethods = ReturnType<typeof createConversationTagMethods>;