librechat-data-provider 0.8.521 → 0.8.523

package/dist/types/data-service.d.ts

@@ -1,8 +1,12 @@
 import type { AxiosResponse } from 'axios';
+import type { TTracePage, TTracePageParams, TTraceAvailability, TTraceRecordParams, TTraceRecordDetail } from './types/traces';
+import type { TInsightsAccessResponse, TInsightsParams, TInsightsResponse } from './types/insights';
 import type { TFileConfig } from './file-config';
 import type * as t from './types';
 import * as permissions from './accessPermissions';
 import * as mcp from './types/mcpServers';
+import * as qt from './types/queuedTurns';
+import * as sch from './types/schedules';
 import * as a from './types/assistants';
 import * as m from './types/mutations';
 import * as ag from './types/agents';
@@ -12,6 +16,11 @@ import * as f from './types/files';
 import * as config from './config';
 import * as s from './schemas';
 import * as r from './roles';
+export declare function getInsights(params?: TInsightsParams): Promise<TInsightsResponse>;
+export declare function getInsightsAccess(): Promise<TInsightsAccessResponse>;
+export declare function getConversationTraceAvailability(conversationId: string): Promise<TTraceAvailability>;
+export declare function getConversationTraceRecords({ conversationId, cursor }: TTracePageParams, signal?: AbortSignal): Promise<TTracePage>;
+export declare function getConversationTraceRecord({ conversationId, recordId, messageId, sourceId }: TTraceRecordParams, signal?: AbortSignal): Promise<TTraceRecordDetail>;
 export declare function getLangfuseConnection(): Promise<t.TLangfuseConnectionStatus>;
 export declare function updateLangfuseConnection(payload: t.TUpdateLangfuseConnectionRequest): Promise<t.TLangfuseConnectionStatus>;
 export declare function testLangfuseConnection(payload: t.TLangfuseConnectionTestRequest): Promise<t.TLangfuseConnectionTestResponse>;
@@ -19,8 +28,26 @@ export declare function getLangfuseSessionLink(conversationId: string): Promise<
 export declare function revokeUserKey(name: string): Promise<unknown>;
 export declare function revokeAllUserKeys(): Promise<unknown>;
 export declare function deleteUser(payload?: t.TDeleteUserRequest): Promise<unknown>;
+export declare function getCodeEnvironments(): Promise<t.TCodeEnvironmentsResponse>;
+export declare function getCodeEnvironmentStatus(id: string): Promise<t.TCodeEnvironmentStatusResponse>;
+export declare function pairCodeEnvironment(payload: {
+    name: string;
+    controlPlaneId: string;
+}): Promise<t.TCodeEnvironmentPairingResponse>;
+export declare function deleteCodeEnvironment(id: string): Promise<{
+    environment: t.TCodeEnvironmentSummary;
+}>;
+export declare function updateCodeEnvironmentSettings({ id, settings, }: {
+    id: string;
+    settings: config.CodeEnvironmentUserSettings;
+}): Promise<{
+    environment: t.TCodeEnvironmentSummary;
+}>;
 export declare function getFavorites(): Promise<q.TUserFavorite[]>;
 export declare function updateFavorites(favorites: q.TUserFavorite[]): Promise<q.TUserFavorite[]>;
+/** Combined Pinned-section display order: favorite and pinned-chat entry keys interleaved. */
+export declare function getPinnedOrder(): Promise<string[]>;
+export declare function updatePinnedOrder(pinnedOrder: string[]): Promise<string[]>;
 /** Tool favorites — starred marketplace items (builtins, tools, MCP servers, skills). */
 export declare function getToolFavorites(): Promise<q.TToolFavorite[]>;
 export declare function addToolFavorite(favorite: q.TToolFavorite): Promise<q.TToolFavorite>;
@@ -47,6 +74,7 @@ export declare function updatePreset(payload: s.TPreset): Promise<s.TPreset>;
 export declare function deletePreset(arg: s.TPreset | undefined): Promise<m.PresetDeleteResponse>;
 export declare function getSearchEnabled(): Promise<boolean>;
 export declare function getUser(): Promise<t.TUser>;
+export declare function updateUserPreferences(preferences: t.TUpdateUserPreferencesRequest): Promise<t.TUpdateUserPreferencesResponse>;
 export declare function getUserBalance(): Promise<t.TBalanceResponse>;
 export declare const updateTokenCount: (text: string) => Promise<any>;
 export declare const login: (payload: t.TLoginUser) => Promise<t.TLoginResponse>;
@@ -248,6 +276,7 @@ export declare function getConversations(cursor: string): Promise<t.TGetConversa
 export declare function getConversationById(id: string): Promise<s.TConversation>;
 export declare function updateConversation(payload: t.TUpdateConversationRequest): Promise<t.TUpdateConversationResponse>;
 export declare function archiveConversation(payload: t.TArchiveConversationRequest): Promise<t.TArchiveConversationResponse>;
+export declare function archiveAllConversations(): Promise<t.TArchiveAllConversationsResponse>;
 export declare function listProjects(params?: q.ProjectListParams): Promise<q.ProjectListResponse>;
 export declare function createProject(payload: t.TCreateChatProjectRequest): Promise<t.TChatProject>;
 export declare function getProjectById(projectId: string): Promise<t.TChatProject>;
@@ -262,6 +291,10 @@ export declare function updateMessageContent(payload: t.TUpdateMessageContent):
 export declare const editArtifact: ({ messageId, ...params }: m.TEditArtifactRequest) => Promise<m.TEditArtifactResponse>;
 export declare const branchMessage: (payload: m.TBranchMessageRequest) => Promise<m.TBranchMessageResponse>;
 export declare function getMessagesByConvoId(conversationId: string): Promise<s.TMessage[]>;
+export declare function getMessageById(conversationId: string, messageId: string): Promise<s.TMessage[]>;
+export declare function getParentSubagents(parentConversationId: string): Promise<t.ParentSubagentIndex>;
+export declare function getSubagentThread(parentConversationId: string, threadId: string, taskId?: string, cursor?: string): Promise<t.SubagentThreadView>;
+export declare function controlSubagentTask(parentConversationId: string, threadId: string, body: t.SubagentControlRequest): Promise<t.SubagentControlResponse>;
 export declare function getPrompt(id: string): Promise<{
     prompt: t.TPrompt;
 }>;
@@ -282,6 +315,17 @@ export declare function deletePromptGroup(id: string): Promise<t.TDeletePromptGr
 export declare function getCategories(): Promise<t.TGetCategoriesResponse>;
 export declare function getRandomPrompts(variables: t.TGetRandomPromptsRequest): Promise<t.TGetRandomPromptsResponse>;
 export declare function listSkills(params?: sk.TSkillListRequest): Promise<sk.TSkillListResponse>;
+export declare function getSchedules(): Promise<sch.TSchedulesResponse>;
+export declare function enqueueAgentQueuedTurn(payload: qt.TEnqueueAgentQueuedTurnRequest): Promise<qt.TEnqueueAgentQueuedTurnResponse>;
+export declare function listAgentQueuedTurns(conversationId: string, clientRequestIds?: string[]): Promise<qt.TListAgentQueuedTurnsResponse>;
+export declare function cancelAgentQueuedTurn(queuedTurnId: string): Promise<qt.TCancelAgentQueuedTurnResponse>;
+export declare function getSchedule(id: string): Promise<sch.TSchedule>;
+export declare function createSchedule(payload: sch.TCreateSchedule): Promise<sch.TSchedule>;
+export declare function updateSchedule(id: string, payload: sch.TUpdateSchedule): Promise<sch.TSchedule>;
+export declare function deleteSchedule(id: string): Promise<{
+    id: string;
+}>;
+export declare function runScheduleNow(id: string): Promise<sch.TScheduleRunNowResponse>;
 export declare function getSkill(id: string): Promise<sk.TSkill>;
 export declare function createSkill(payload: sk.TCreateSkill): Promise<sk.TSkill>;
 export declare function updateSkill(variables: sk.TUpdateSkillVariables): Promise<sk.TUpdateSkillResponse>;
@@ -357,8 +401,10 @@ export declare function disableTwoFactor(payload?: t.TDisable2FARequest): Promis
 export declare function regenerateBackupCodes(payload?: t.TRegenerateBackupCodesRequest): Promise<t.TRegenerateBackupCodesResponse>;
 export declare function verifyTwoFactorTemp(payload: t.TVerify2FATempRequest): Promise<t.TVerify2FATempResponse>;
 export declare const getMemories: () => Promise<q.MemoriesResponse>;
-export declare const deleteMemory: (key: string, agentId?: string) => Promise<void>;
-export declare const updateMemory: (key: string, value: string, originalKey?: string, agentId?: string) => Promise<q.TUserMemory>;
+export declare const deleteMemory: (key: string, agentId?: string) => Promise<q.DeleteMemoryResponse>;
+export declare const deleteMemoryById: (id: string, agentId?: string) => Promise<q.DeleteMemoryResponse>;
+export declare const updateMemory: (key: string, value: string, originalKey?: string, agentId?: string) => Promise<q.UpdateMemoryResponse>;
+export declare const updateMemoryById: (id: string, value: string, key?: string, agentId?: string) => Promise<q.UpdateMemoryResponse>;
 export declare const updateMemoryPreferences: (preferences: {
     memories: boolean;
 }) => Promise<{

package/dist/types/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function hasToolCallErrorPrefix(text: string): boolean;
+export declare function stripToolCallErrorPrefix(text: string): string;

package/dist/types/file-config.d.ts

@@ -20,6 +20,35 @@ export declare const imageExtRegex: RegExp;
 export type BedrockDocumentFormat = 'pdf' | 'csv' | 'doc' | 'docx' | 'xls' | 'xlsx' | 'html' | 'txt' | 'md';
 /** Maps MIME types to Bedrock Converse API document format values */
 export declare const bedrockDocumentFormats: Record<string, BedrockDocumentFormat>;
+/**
+ * Whether an upload belongs to the conversation rather than to the agent. The value
+ * arrives from multipart form data, so it can be the string "false", which is truthy.
+ * Shared so the route, the authorization check and processing cannot disagree about it.
+ */
+export declare const isMessageFileUpload: (value?: boolean | string | null) => boolean;
+/**
+ * Whether the upload's conversation uses the Responses API, which decides whether Azure
+ * can carry a document natively. Multipart form data has no booleans, so it arrives as
+ * the string "true".
+ */
+export declare const isResponsesApiUpload: (value?: boolean | string | null) => boolean;
+/**
+ * The name a file carries inside the code sandbox.
+ *
+ * Image uploads are converted to the configured output type while the record keeps the
+ * original filename, so the extension has to follow the stored bytes or the sandbox
+ * decoder is handed a mismatch. Provisioning and priming both resolve the mount path
+ * from here: deriving it twice under different rules leaves a later turn advertising a
+ * path that does not exist in the sandbox.
+ */
+export declare const resolveSandboxFilename: (filename: string, mimeType?: string | null) => string;
+/**
+ * The Responses setting a turn actually runs on. A saved agent's own record wins, since
+ * execution reads its model parameters; a conversation only answers for itself. Upload
+ * and delivery must agree here, or a document is stored as raw provider content and then
+ * re-resolved to text it has no extraction for.
+ */
+export declare const resolveUseResponsesApi: (agentValue?: boolean | null, conversationValue?: boolean | null) => boolean | undefined;
 export declare const isBedrockDocumentType: (mimeType?: string) => boolean;
 /** MIME types Bedrock's Converse document path can send to the model (mirrors `bedrockDocumentFormats`). */
 export declare const bedrockDocumentMimeTypes: readonly string[];
@@ -114,11 +143,14 @@ export declare const fileConfig: {
     serverFileSizeLimit: number;
     avatarSizeLimit: number;
     fileTokenLimit: number;
+    fileContextSizeLimit: number;
+    fileContextCharLimit: number;
     clientImageResize: {
         enabled: boolean;
         maxWidth: number;
         maxHeight: number;
         quality: number;
+        enforced: boolean;
     };
     ocr: {
         supportedMimeTypes: RegExp[];
@@ -131,24 +163,58 @@ export declare const fileConfig: {
     };
     checkType: (fileType: string, supportedTypes?: RegexLike[]) => boolean;
 };
+export declare const DefaultLLMDeliveryPath: z.ZodEnum<["provider", "text", "none"]>;
+export type TDefaultLLMDeliveryPath = z.infer<typeof DefaultLLMDeliveryPath>;
+export declare const defaultLLMDeliveryPathSchema: z.ZodObject<{
+    fallback: z.ZodOptional<z.ZodEnum<["provider", "text", "none"]>>;
+    overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["provider", "text", "none"]>>>;
+}, "strip", z.ZodTypeAny, {
+    fallback?: "none" | "provider" | "text" | undefined;
+    overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+}, {
+    fallback?: "none" | "provider" | "text" | undefined;
+    overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+}>;
+export type TDefaultLLMDeliveryPathConfig = z.infer<typeof defaultLLMDeliveryPathSchema>;
 export declare const endpointFileConfigSchema: z.ZodObject<{
     disabled: z.ZodOptional<z.ZodBoolean>;
     fileLimit: z.ZodOptional<z.ZodNumber>;
     fileSizeLimit: z.ZodOptional<z.ZodNumber>;
     totalSizeLimit: z.ZodOptional<z.ZodNumber>;
     supportedMimeTypes: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    defaultLLMDeliveryPath: z.ZodOptional<z.ZodObject<{
+        fallback: z.ZodOptional<z.ZodEnum<["provider", "text", "none"]>>;
+        overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["provider", "text", "none"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        fallback?: "none" | "provider" | "text" | undefined;
+        overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+    }, {
+        fallback?: "none" | "provider" | "text" | undefined;
+        overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+    }>>;
+    legacyFileUploadUX: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     disabled?: boolean | undefined;
     fileLimit?: number | undefined;
     fileSizeLimit?: number | undefined;
     totalSizeLimit?: number | undefined;
     supportedMimeTypes?: string[] | undefined;
+    defaultLLMDeliveryPath?: {
+        fallback?: "none" | "provider" | "text" | undefined;
+        overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+    } | undefined;
+    legacyFileUploadUX?: boolean | undefined;
 }, {
     disabled?: boolean | undefined;
     fileLimit?: number | undefined;
     fileSizeLimit?: number | undefined;
     totalSizeLimit?: number | undefined;
     supportedMimeTypes?: string[] | undefined;
+    defaultLLMDeliveryPath?: {
+        fallback?: "none" | "provider" | "text" | undefined;
+        overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+    } | undefined;
+    legacyFileUploadUX?: boolean | undefined;
 }>;
 export declare const fileConfigSchema: z.ZodObject<{
     endpoints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -157,18 +223,39 @@ export declare const fileConfigSchema: z.ZodObject<{
         fileSizeLimit: z.ZodOptional<z.ZodNumber>;
         totalSizeLimit: z.ZodOptional<z.ZodNumber>;
         supportedMimeTypes: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        defaultLLMDeliveryPath: z.ZodOptional<z.ZodObject<{
+            fallback: z.ZodOptional<z.ZodEnum<["provider", "text", "none"]>>;
+            overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["provider", "text", "none"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            fallback?: "none" | "provider" | "text" | undefined;
+            overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+        }, {
+            fallback?: "none" | "provider" | "text" | undefined;
+            overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+        }>>;
+        legacyFileUploadUX: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         disabled?: boolean | undefined;
         fileLimit?: number | undefined;
         fileSizeLimit?: number | undefined;
         totalSizeLimit?: number | undefined;
         supportedMimeTypes?: string[] | undefined;
+        defaultLLMDeliveryPath?: {
+            fallback?: "none" | "provider" | "text" | undefined;
+            overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+        } | undefined;
+        legacyFileUploadUX?: boolean | undefined;
     }, {
         disabled?: boolean | undefined;
         fileLimit?: number | undefined;
         fileSizeLimit?: number | undefined;
         totalSizeLimit?: number | undefined;
         supportedMimeTypes?: string[] | undefined;
+        defaultLLMDeliveryPath?: {
+            fallback?: "none" | "provider" | "text" | undefined;
+            overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+        } | undefined;
+        legacyFileUploadUX?: boolean | undefined;
     }>>>;
     skills: z.ZodOptional<z.ZodObject<{
         fileSizeLimit: z.ZodOptional<z.ZodNumber>;
@@ -180,6 +267,9 @@ export declare const fileConfigSchema: z.ZodObject<{
     serverFileSizeLimit: z.ZodOptional<z.ZodNumber>;
     avatarSizeLimit: z.ZodOptional<z.ZodNumber>;
     fileTokenLimit: z.ZodOptional<z.ZodNumber>;
+    fileContextSizeLimit: z.ZodOptional<z.ZodNumber>;
+    fileContextCharLimit: z.ZodOptional<z.ZodNumber>;
+    codeEnvLivenessSafeWindowMs: z.ZodOptional<z.ZodNumber>;
     imageGeneration: z.ZodOptional<z.ZodObject<{
         percentage: z.ZodOptional<z.ZodNumber>;
         px: z.ZodOptional<z.ZodNumber>;
@@ -220,23 +310,50 @@ export declare const fileConfigSchema: z.ZodObject<{
     }, {
         supportedMimeTypes?: string[] | undefined;
     }>>;
+    defaultLLMDeliveryPath: z.ZodOptional<z.ZodObject<{
+        fallback: z.ZodOptional<z.ZodEnum<["provider", "text", "none"]>>;
+        overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["provider", "text", "none"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        fallback?: "none" | "provider" | "text" | undefined;
+        overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+    }, {
+        fallback?: "none" | "provider" | "text" | undefined;
+        overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+    }>>;
+    legacyFileUploadUX: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    fileTokenLimit?: number | undefined;
-    text?: {
+    ocr?: {
         supportedMimeTypes?: string[] | undefined;
     } | undefined;
     skills?: {
         fileSizeLimit?: number | undefined;
     } | undefined;
+    text?: {
+        supportedMimeTypes?: string[] | undefined;
+    } | undefined;
+    fileTokenLimit?: number | undefined;
+    defaultLLMDeliveryPath?: {
+        fallback?: "none" | "provider" | "text" | undefined;
+        overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+    } | undefined;
+    legacyFileUploadUX?: boolean | undefined;
     endpoints?: Record<string, {
         disabled?: boolean | undefined;
         fileLimit?: number | undefined;
         fileSizeLimit?: number | undefined;
         totalSizeLimit?: number | undefined;
         supportedMimeTypes?: string[] | undefined;
+        defaultLLMDeliveryPath?: {
+            fallback?: "none" | "provider" | "text" | undefined;
+            overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+        } | undefined;
+        legacyFileUploadUX?: boolean | undefined;
     }> | undefined;
     serverFileSizeLimit?: number | undefined;
     avatarSizeLimit?: number | undefined;
+    fileContextSizeLimit?: number | undefined;
+    fileContextCharLimit?: number | undefined;
+    codeEnvLivenessSafeWindowMs?: number | undefined;
     imageGeneration?: {
         percentage?: number | undefined;
         px?: number | undefined;
@@ -247,26 +364,39 @@ export declare const fileConfigSchema: z.ZodObject<{
         maxHeight?: number | undefined;
         quality?: number | undefined;
     } | undefined;
+}, {
     ocr?: {
         supportedMimeTypes?: string[] | undefined;
     } | undefined;
-}, {
-    fileTokenLimit?: number | undefined;
+    skills?: {
+        fileSizeLimit?: number | undefined;
+    } | undefined;
     text?: {
         supportedMimeTypes?: string[] | undefined;
     } | undefined;
-    skills?: {
-        fileSizeLimit?: number | undefined;
+    fileTokenLimit?: number | undefined;
+    defaultLLMDeliveryPath?: {
+        fallback?: "none" | "provider" | "text" | undefined;
+        overrides?: Record<string, "none" | "provider" | "text"> | undefined;
     } | undefined;
+    legacyFileUploadUX?: boolean | undefined;
     endpoints?: Record<string, {
         disabled?: boolean | undefined;
         fileLimit?: number | undefined;
         fileSizeLimit?: number | undefined;
         totalSizeLimit?: number | undefined;
         supportedMimeTypes?: string[] | undefined;
+        defaultLLMDeliveryPath?: {
+            fallback?: "none" | "provider" | "text" | undefined;
+            overrides?: Record<string, "none" | "provider" | "text"> | undefined;
+        } | undefined;
+        legacyFileUploadUX?: boolean | undefined;
     }> | undefined;
     serverFileSizeLimit?: number | undefined;
     avatarSizeLimit?: number | undefined;
+    fileContextSizeLimit?: number | undefined;
+    fileContextCharLimit?: number | undefined;
+    codeEnvLivenessSafeWindowMs?: number | undefined;
     imageGeneration?: {
         percentage?: number | undefined;
         px?: number | undefined;
@@ -277,9 +407,6 @@ export declare const fileConfigSchema: z.ZodObject<{
         maxHeight?: number | undefined;
         quality?: number | undefined;
     } | undefined;
-    ocr?: {
-        supportedMimeTypes?: string[] | undefined;
-    } | undefined;
 }>;
 export type TFileConfig = z.infer<typeof fileConfigSchema>;
 /** Override the MIME-pattern compiler; the server injects a linear-time engine at startup. */
@@ -297,6 +424,8 @@ export interface MimeUploadCapability {
     /** When `document` is permitted, restrict document types to this set (e.g. Bedrock formats); default: all. */
     documentMimeTypes?: readonly string[];
 }
+/** Preferred extension for a known document MIME type, including its leading dot. */
+export declare function getDocumentFileExtension(mimeType?: string): string | undefined;
 /**
  * Resolves the file-input `accept` value for a configured `supportedMimeTypes` allowlist, scoped to
  * what the current upload path (`capability`) can send to the model.