librechat-data-provider 0.8.509 → 0.8.522

package/dist/types/types/files.d.ts

@@ -1,5 +1,5 @@
+import type { CodeEnvRef, CodeEnvRefMap } from '../codeEnvRef';
 import { EToolResources } from './assistants';
-import type { CodeEnvRef } from '../codeEnvRef';
 export declare enum FileSources {
     local = "local",
     firebase = "firebase",
@@ -34,12 +34,16 @@ export declare enum FileContext {
     context = "context",
     bytes = "bytes"
 }
+/** Structural type for a compiled matcher: a native `RegExp` or a linear-time engine both satisfy it. Only `test` is ever called on `supportedMimeTypes`. */
+export type RegexLike = {
+    test(input: string): boolean;
+};
 export type EndpointFileConfig = {
     disabled?: boolean;
     fileLimit?: number;
     fileSizeLimit?: number;
     totalSizeLimit?: number;
-    supportedMimeTypes?: RegExp[];
+    supportedMimeTypes?: RegexLike[];
 };
 export type FileConfig = {
     endpoints: {
@@ -56,17 +60,19 @@ export type FileConfig = {
         maxWidth?: number;
         maxHeight?: number;
         quality?: number;
+        /** Set when `enabled` came from the admin config, in which case it wins over the user's setting */
+        enforced?: boolean;
     };
     ocr?: {
-        supportedMimeTypes?: RegExp[];
+        supportedMimeTypes?: RegexLike[];
     };
     text?: {
-        supportedMimeTypes?: RegExp[];
+        supportedMimeTypes?: RegexLike[];
     };
     stt?: {
-        supportedMimeTypes?: RegExp[];
+        supportedMimeTypes?: RegexLike[];
     };
-    checkType?: (fileType: string, supportedTypes: RegExp[]) => boolean;
+    checkType?: (fileType: string, supportedTypes: RegexLike[]) => boolean;
 };
 export type FileConfigInput = {
     endpoints?: {
@@ -92,7 +98,7 @@ export type FileConfigInput = {
     stt?: {
         supportedMimeTypes?: string[];
     };
-    checkType?: (fileType: string, supportedTypes: RegExp[]) => boolean;
+    checkType?: (fileType: string, supportedTypes: RegexLike[]) => boolean;
 };
 export type TFile = {
     _id?: string;
@@ -151,6 +157,9 @@ export type TFile = {
          * resolve via `resolveCodeEnvRef`.
          */
         codeEnvRef?: CodeEnvRef;
+        codeEnvRefs?: CodeEnvRefMap;
+        /** Dispatch-order stamp for the current source artifact generation. */
+        sourceDispatchedAt?: number;
     };
     createdAt?: string | Date;
     updatedAt?: string | Date;
@@ -217,9 +226,18 @@ export type VoiceOptions = {
     onMutate?: () => void | Promise<unknown>;
     onError?: (error: unknown, variables: unknown, context?: unknown) => void;
 };
+export type TFilesUsageBody = {
+    file_ids: string[];
+};
+export type TFilesUsageResponse = {
+    /** Count of queued uploads whose TTL hold was extended. */
+    held: number;
+};
 export type DeleteFilesResponse = {
     message: string;
-    result: Record<string, unknown>;
+    result?: Record<string, unknown>;
+    deletedFileIds?: string[];
+    failedFileIds?: string[];
 };
 export type BatchFile = {
     file_id: string;
@@ -240,4 +258,7 @@ export type DeleteMutationOptions = {
     onSuccess?: (data: DeleteFilesResponse, variables: DeleteFilesBody, context?: unknown) => void;
     onMutate?: (variables: DeleteFilesBody) => void | Promise<unknown>;
     onError?: (error: unknown, variables: DeleteFilesBody, context?: unknown) => void;
+    /** Suppresses the result toasts. Background cleanup runs on a timer the user never asked for,
+     * and a storage failure that keeps failing would otherwise announce itself on every retry. */
+    silent?: boolean;
 };

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

@@ -1,2 +1,4 @@
 export * from './queries';
 export * from './mcpServers';
+export * from './subagents';
+export * from './queuedTurns';

package/dist/types/types/insights.d.ts

@@ -0,0 +1,62 @@
+export type InsightsRange = '24h' | '7d' | '30d' | 'custom';
+export declare const INSIGHTS_MAX_RANGE_DAYS = 30;
+export declare const INSIGHTS_SEARCH_MIN_LENGTH = 3;
+export declare const INSIGHTS_SEARCH_MAX_LENGTH = 200;
+export type TInsightsParams = {
+    range?: InsightsRange;
+    fromTimestamp?: string;
+    toTimestamp?: string;
+    timeZone?: string;
+    search?: string;
+    page?: number;
+    pageSize?: number;
+};
+export type TInsightsDailyPoint = {
+    date: string;
+    conversations: number;
+    users: number;
+    messages: number;
+    totalTokens: number;
+};
+export type TInsightsUser = {
+    userId: string;
+    name: string;
+    email: string;
+    conversations: number;
+    messages: number;
+};
+export type TInsightsChurnedUser = TInsightsUser & {
+    firstSeen: string;
+    lastSeen: string;
+};
+export type TInsightsConversation = {
+    conversationId: string;
+    date: string;
+    userId: string;
+    name: string;
+    email: string;
+    firstMessage: string;
+    messages: number;
+    totalTokens: number;
+};
+export type TInsightsSummary = {
+    totalUsers: number;
+    totalConversations: number;
+    totalMessages: number;
+    totalTokens: number;
+};
+export type TInsightsResponse = {
+    summary: TInsightsSummary;
+    daily: TInsightsDailyPoint[];
+    topUsers: TInsightsUser[];
+    churnedUsers: TInsightsChurnedUser[];
+    latest: {
+        conversations: TInsightsConversation[];
+        page: number;
+        pageSize: number;
+        pages: number;
+    };
+};
+export type TInsightsAccessResponse = {
+    access: boolean;
+};

package/dist/types/types/mcpServers.d.ts

@@ -39,5 +39,30 @@ export type MCPServerDBObjectResponse = {
     serverName: string;
     /** True if access is only via agent (not directly shared with user) */
     consumeOnly?: boolean;
+    /** True when chat request fields are required before the server can connect. */
+    requestScoped?: boolean;
 } & MCPOptions;
 export type MCPServersListResponse = Record<string, MCPServerDBObjectResponse>;
+export type MCPReinitializeFailureReason = 'unreachable' | 'missing_custom_user_vars' | 'oauth_required' | 'initialization_failed';
+export interface MCPReinitializeResponse {
+    success: boolean;
+    message: string;
+    serverName: string;
+    oauthRequired?: boolean;
+    oauthUrl?: string | null;
+    /** Shared OAuth attempt identifier used to poll durable flow state. */
+    flowId?: string;
+    /** Remaining OAuth completion window for this attempt, in milliseconds. */
+    oauthTimeout?: number;
+    failureReason?: MCPReinitializeFailureReason;
+    missingUserVars?: string[];
+    /** True when the server uses request-scoped placeholders and the connection
+     *  was deferred to the next chat turn (tools are not enumerable up front). */
+    connectionDeferred?: boolean;
+}
+export interface MCPOAuthStatusResponse {
+    status: 'PENDING' | 'COMPLETED' | 'FAILED';
+    completed: boolean;
+    failed: boolean;
+    error?: string;
+}

package/dist/types/types/mutations.d.ts

@@ -114,10 +114,12 @@ export type ArchiveConversationOptions = MutationOptions<types.TArchiveConversat
 export type PinConversationOptions = MutationOptions<types.TPinConversationResponse, types.TPinConversationRequest>;
 export type DuplicateConvoOptions = MutationOptions<types.TDuplicateConvoResponse, types.TDuplicateConvoRequest>;
 export type ForkConvoOptions = MutationOptions<types.TForkConvoResponse, types.TForkConvoRequest>;
+export type ForkSharedConvoOptions = MutationOptions<types.TForkConvoResponse, types.TForkSharedConvoRequest>;
 export type CreateSharedLinkOptions = MutationOptions<types.TSharedLink, Partial<types.TSharedLink>>;
 export type updateTagsInConvoOptions = MutationOptions<types.TTagConversationResponse, types.TTagConversationRequest>;
 export type UpdateSharedLinkOptions = MutationOptions<types.TSharedLink, Partial<types.TSharedLink>>;
 export type ArchiveConvoOptions = MutationOptions<types.TArchiveConversationResponse, types.TArchiveConversationRequest>;
+export type ArchiveAllConversationsOptions = MutationOptions<types.TArchiveAllConversationsResponse, void>;
 export type DeleteSharedLinkContext = {
     previousQueries?: Map<string, TDeleteSharedLinkResponse>;
 };

package/dist/types/types/queries.d.ts

@@ -1,4 +1,5 @@
 import type { InfiniteData } from '@tanstack/react-query';
+import type { RerankerTypes, SearchProviders, ScraperProviders } from '../config';
 import type * as p from '../accessPermissions';
 import type * as a from '../types/agents';
 import type * as s from '../schemas';
@@ -12,14 +13,16 @@ export type Conversation = {
 };
 export type ConversationListParams = {
     cursor?: string;
+    limit?: number;
     isArchived?: boolean;
-    sortBy?: 'title' | 'createdAt' | 'updatedAt';
+    pinned?: boolean;
+    sortBy?: 'title' | 'createdAt' | 'updatedAt' | 'archivedAt';
     sortDirection?: 'asc' | 'desc';
     tags?: string[];
     search?: string;
     projectId?: string;
 };
-export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'user' | 'chatProjectId'>;
+export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'archivedAt' | 'user' | 'chatProjectId' | 'pinned'>;
 export type ConversationListResponse = {
     conversations: MinimalConversation[];
     nextCursor: string | null;
@@ -64,7 +67,7 @@ export interface SharedLinksListParams {
 export type SharedLinkItem = {
     shareId: string;
     title: string;
-    createdAt: Date;
+    createdAt: string;
     conversationId: string;
 };
 export interface SharedLinksResponse {
@@ -92,6 +95,9 @@ export type MCPTool = {
     name: string;
     pluginKey: string;
     description: string;
+    /** Raw upstream tool name when the model-facing key stripped a redundant
+     *  server-name prefix — gates the agent editor's legacy id migration. */
+    serverToolName?: string;
 };
 export type MCPServer = {
     name: string;
@@ -110,16 +116,29 @@ export type VerifyToolAuthResponse = {
     authenticated: boolean;
     message?: string | s.AuthType;
     authTypes?: [string, s.AuthType][];
+    searchProvider?: SearchProviders;
+    scraperProvider?: ScraperProviders;
+    rerankerType?: RerankerTypes;
 };
 export type GetToolCallParams = {
     conversationId: string;
 };
 export type ToolCallResults = a.ToolCallResult[];
 export type TUserMemory = {
+    /** Stable stored record identifier retained when content fields are redacted. */
+    _id?: string;
     key: string;
     value: string;
+    /** Optional generated or legacy summary content. */
+    summary?: string;
     updated_at: string;
     tokenCount?: number;
+    /** Agent partition this memory belongs to; absent = shared personal pool */
+    agentId?: string;
+    /** Display name of the partition's agent, resolved server-side when available */
+    agentName?: string;
+    /** Current policy removed one or more memory content fields from this response. */
+    contentFilterBlocked?: boolean;
 };
 export type MemoriesResponse = {
     memories: TUserMemory[];
@@ -127,6 +146,13 @@ export type MemoriesResponse = {
     tokenLimit: number | null;
     usagePercentage: number | null;
 };
+export type UpdateMemoryResponse = {
+    updated: boolean;
+    memory: TUserMemory;
+};
+export type DeleteMemoryResponse = {
+    deleted: boolean;
+};
 export type PrincipalSearchParams = {
     q: string;
     limit?: number;
@@ -162,7 +188,12 @@ export type ListRolesResponse = {
 };
 export interface MCPServerStatus {
     requiresOAuth: boolean;
+    /** The server connects only inside a chat request because its config reads BODY placeholders. */
+    requestScoped?: boolean;
+    /** Whether all declared per-user variables are present for an on-demand connection. */
+    configurationState?: 'configured' | 'needs_configuration';
     connectionState: 'disconnected' | 'connecting' | 'connected' | 'error';
+    authorizationState?: 'not_required' | 'authorizing' | 'authorized' | 'needs_authorization' | 'error';
 }
 export interface MCPConnectionStatusResponse {
     success: boolean;
@@ -174,7 +205,10 @@ export interface MCPServerConnectionStatusResponse {
     success: boolean;
     serverName: string;
     requiresOAuth: boolean;
+    requestScoped?: boolean;
+    configurationState?: MCPServerStatus['configurationState'];
     connectionStatus: 'disconnected' | 'connecting' | 'connected' | 'error';
+    authorizationState?: MCPServerStatus['authorizationState'];
 }
 export interface MCPAuthValuesResponse {
     success: boolean;
@@ -191,8 +225,16 @@ export type TUserFavorite = {
     model?: string;
     endpoint?: string;
     spec?: string;
-    /** Phase 2 — skill favoriting isn't persisted yet, but the shape is reserved. */
-    skillId?: string;
+};
+/**
+ * Tool favorites — starred marketplace items (built-in capabilities, plugin
+ * tools, MCP servers, skills). Identity is the compound (itemType, itemId)
+ * pair, matching the marketplace `itemKey` format `itemType:itemId`.
+ */
+export type TToolFavoriteType = 'builtin' | 'tool' | 'mcp' | 'skill';
+export type TToolFavorite = {
+    itemType: TToolFavoriteType;
+    itemId: string;
 };
 export type GraphTokenParams = {
     scopes: string;