librechat-data-provider 0.8.522 → 0.8.523

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

@@ -1,4 +1,5 @@
 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';
@@ -17,6 +18,9 @@ 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>;
@@ -25,6 +29,7 @@ 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;
@@ -40,6 +45,9 @@ export declare function updateCodeEnvironmentSettings({ id, settings, }: {
 }>;
 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>;

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,6 +143,8 @@ export declare const fileConfig: {
     serverFileSizeLimit: number;
     avatarSizeLimit: number;
     fileTokenLimit: number;
+    fileContextSizeLimit: number;
+    fileContextCharLimit: number;
     clientImageResize: {
         enabled: boolean;
         maxWidth: number;
@@ -132,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<{
@@ -158,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>;
@@ -181,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>;
@@ -221,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;
@@ -248,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;
@@ -278,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. */
@@ -298,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.