librechat-data-provider 0.8.522 → 0.8.524

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

@@ -1,6 +1,8 @@
 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 tl from './types/tools';
 import type * as t from './types';
 import * as permissions from './accessPermissions';
 import * as mcp from './types/mcpServers';
@@ -17,6 +19,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 +30,8 @@ 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 moveConversationCodeEnvironment({ conversationId, from, to, }: t.TCodeEnvironmentMoveRequest): Promise<t.TCodeEnvironmentMoveResponse>;
 export declare function pairCodeEnvironment(payload: {
     name: string;
     controlPlaneId: string;
@@ -40,6 +47,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>;
@@ -165,30 +175,30 @@ export declare const deleteAction: ({ assistant_id, action_id, model, version, e
 /**
  * Agents
  */
-export declare const createAgent: ({ ...data }: a.AgentCreateParams) => Promise<a.Agent>;
+export declare const createAgent: ({ ...data }: ag.AgentCreateParams) => Promise<ag.Agent>;
 export declare const getAgentById: ({ agent_id }: {
     agent_id: string;
-}) => Promise<a.Agent>;
+}) => Promise<ag.Agent>;
 export declare const getExpandedAgentById: ({ agent_id }: {
     agent_id: string;
-}) => Promise<a.Agent>;
+}) => Promise<ag.Agent>;
 export declare const getAgentVersions: ({ agent_id }: {
     agent_id: string;
-}) => Promise<a.Agent[]>;
+}) => Promise<ag.Agent[]>;
 export declare const updateAgent: ({ agent_id, data, }: {
     agent_id: string;
-    data: a.AgentUpdateParams;
-}) => Promise<a.Agent>;
+    data: ag.AgentUpdateParams;
+}) => Promise<ag.Agent>;
 export declare const duplicateAgent: ({ agent_id, }: m.DuplicateAgentBody) => Promise<{
-    agent: a.Agent;
+    agent: ag.Agent;
     actions: ag.Action[];
 }>;
 export declare const deleteAgent: ({ agent_id }: m.DeleteAgentBody) => Promise<void>;
-export declare const listAgents: (params: a.AgentListParams) => Promise<a.AgentListResponse>;
+export declare const listAgents: (params: ag.AgentListParams) => Promise<ag.AgentListResponse>;
 export declare const revertAgentVersion: ({ agent_id, version_index, }: {
     agent_id: string;
     version_index: number;
-}) => Promise<a.Agent>;
+}) => Promise<ag.Agent>;
 /**
  * Get agent categories with counts for marketplace tabs
  */
@@ -203,7 +213,7 @@ export declare const getMarketplaceAgents: (params: {
     limit?: number;
     cursor?: string;
     promoted?: 0 | 1;
-}) => Promise<a.AgentListResponse>;
+}) => Promise<ag.AgentListResponse>;
 export declare const getAvailableAgentTools: () => Promise<s.TPlugin[]>;
 export declare const updateAgentAction: (data: m.UpdateAgentActionVariables) => Promise<m.UpdateAgentActionResponse>;
 export declare const deleteAgentAction: ({ agent_id, action_id, }: m.DeleteAgentActionVariables) => Promise<void>;
@@ -242,7 +252,7 @@ export declare const deleteMCPServer: (serverName: string) => Promise<{
 export declare const importConversationsFile: (data: FormData) => Promise<t.TImportResponse>;
 export declare const uploadAvatar: (data: FormData) => Promise<f.AvatarUploadResponse>;
 export declare const uploadAssistantAvatar: (data: m.AssistantAvatarVariables) => Promise<a.Assistant>;
-export declare const uploadAgentAvatar: (data: m.AgentAvatarVariables) => Promise<a.Agent>;
+export declare const uploadAgentAvatar: (data: m.AgentAvatarVariables) => Promise<ag.Agent>;
 export declare const getFileDownload: (userId: string, file_id: string) => Promise<AxiosResponse>;
 export declare const getFileDownloadURL: (userId: string, file_id: string) => Promise<f.FileDownloadURLResponse>;
 /** Blob download for a snapshotted file served through a shared link. */
@@ -252,7 +262,7 @@ export declare const deleteFiles: (payload: {
     files: f.BatchFile[];
     agent_id?: string;
     assistant_id?: string;
-    tool_resource?: a.EToolResources;
+    tool_resource?: tl.EToolResources;
 }) => Promise<f.DeleteFilesResponse>;
 export declare const speechToText: (data: FormData) => Promise<f.SpeechToTextResponse>;
 export declare const textToSpeech: (data: FormData) => Promise<ArrayBuffer>;

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

@@ -1,5 +1,8 @@
 import { z } from 'zod';
 import type { EndpointFileConfig, FileConfig, RegexLike } from './types/files';
+import type { ResponsesApiRouting } from './types';
+/** Parallel storage deletions during rollback of a failed skill archive import. */
+export declare const DEFAULT_SKILL_IMPORT_CLEANUP_CONCURRENCY = 8;
 export declare const supportsFiles: {
     openAI: boolean;
     google: boolean;
@@ -20,6 +23,48 @@ 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;
+/** Models whose native OpenAI and Azure execution defaults to Responses. Keep
+ * this shared with client upload routing so documents follow the API that the
+ * backend will actually invoke. Explicit false remains an opt-out. */
+export declare const prefersResponsesApiByModel: (model?: string | null) => boolean;
+/** The server has transport and administrator settings the browser cannot see.
+ * Missing policy never enables model-based uploads (including during upgrades). */
+export declare const resolveEffectiveUseResponsesApi: ({ value, endpoint, model, routing, webSearch, }: {
+    value?: boolean | null;
+    endpoint?: string | null;
+    model?: string | null;
+    routing?: ResponsesApiRouting;
+    webSearch?: 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[];
@@ -110,10 +155,13 @@ export declare const fileConfig: {
     };
     skills: {
         fileSizeLimit: number;
+        importCleanupConcurrency: number;
     };
     serverFileSizeLimit: number;
     avatarSizeLimit: number;
     fileTokenLimit: number;
+    fileContextSizeLimit: number;
+    fileContextCharLimit: number;
     clientImageResize: {
         enabled: boolean;
         maxWidth: number;
@@ -132,24 +180,61 @@ 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" | "text" | "provider" | undefined;
+    overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+}, {
+    fallback?: "none" | "text" | "provider" | undefined;
+    overrides?: Record<string, "none" | "text" | "provider"> | 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">>>;
+    supportedMimeTypes: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "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" | "text" | "provider" | undefined;
+        overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+    }, {
+        fallback?: "none" | "text" | "provider" | undefined;
+        overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+    }>>;
+    legacyFileUploadUX: z.ZodOptional<z.ZodBoolean>;
+    textFallbackWithoutTools: 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" | "text" | "provider" | undefined;
+        overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+    } | undefined;
+    legacyFileUploadUX?: boolean | undefined;
+    textFallbackWithoutTools?: boolean | undefined;
 }, {
     disabled?: boolean | undefined;
     fileLimit?: number | undefined;
     fileSizeLimit?: number | undefined;
     totalSizeLimit?: number | undefined;
     supportedMimeTypes?: string[] | undefined;
+    defaultLLMDeliveryPath?: {
+        fallback?: "none" | "text" | "provider" | undefined;
+        overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+    } | undefined;
+    legacyFileUploadUX?: boolean | undefined;
+    textFallbackWithoutTools?: boolean | undefined;
 }>;
 export declare const fileConfigSchema: z.ZodObject<{
     endpoints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -157,30 +242,60 @@ export declare const fileConfigSchema: z.ZodObject<{
         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">>>;
+        supportedMimeTypes: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "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" | "text" | "provider" | undefined;
+            overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+        }, {
+            fallback?: "none" | "text" | "provider" | undefined;
+            overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+        }>>;
+        legacyFileUploadUX: z.ZodOptional<z.ZodBoolean>;
+        textFallbackWithoutTools: 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" | "text" | "provider" | undefined;
+            overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+        } | undefined;
+        legacyFileUploadUX?: boolean | undefined;
+        textFallbackWithoutTools?: boolean | undefined;
     }, {
         disabled?: boolean | undefined;
         fileLimit?: number | undefined;
         fileSizeLimit?: number | undefined;
         totalSizeLimit?: number | undefined;
         supportedMimeTypes?: string[] | undefined;
+        defaultLLMDeliveryPath?: {
+            fallback?: "none" | "text" | "provider" | undefined;
+            overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+        } | undefined;
+        legacyFileUploadUX?: boolean | undefined;
+        textFallbackWithoutTools?: boolean | undefined;
     }>>>;
     skills: z.ZodOptional<z.ZodObject<{
         fileSizeLimit: z.ZodOptional<z.ZodNumber>;
+        importCleanupConcurrency: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         fileSizeLimit?: number | undefined;
+        importCleanupConcurrency?: number | undefined;
     }, {
         fileSizeLimit?: number | undefined;
+        importCleanupConcurrency?: number | undefined;
     }>>;
     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>;
@@ -208,36 +323,67 @@ export declare const fileConfigSchema: z.ZodObject<{
         quality?: number | undefined;
     }>>;
     ocr: z.ZodOptional<z.ZodObject<{
-        supportedMimeTypes: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        supportedMimeTypes: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>>;
     }, "strip", z.ZodTypeAny, {
         supportedMimeTypes?: string[] | undefined;
     }, {
         supportedMimeTypes?: string[] | undefined;
     }>>;
     text: z.ZodOptional<z.ZodObject<{
-        supportedMimeTypes: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        supportedMimeTypes: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>>;
     }, "strip", z.ZodTypeAny, {
         supportedMimeTypes?: string[] | undefined;
     }, {
         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" | "text" | "provider" | undefined;
+        overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+    }, {
+        fallback?: "none" | "text" | "provider" | undefined;
+        overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+    }>>;
+    legacyFileUploadUX: z.ZodOptional<z.ZodBoolean>;
+    textFallbackWithoutTools: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    fileTokenLimit?: number | undefined;
     text?: {
         supportedMimeTypes?: string[] | undefined;
     } | undefined;
     skills?: {
         fileSizeLimit?: number | undefined;
+        importCleanupConcurrency?: number | undefined;
+    } | undefined;
+    fileTokenLimit?: number | undefined;
+    ocr?: {
+        supportedMimeTypes?: string[] | undefined;
     } | undefined;
+    defaultLLMDeliveryPath?: {
+        fallback?: "none" | "text" | "provider" | undefined;
+        overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+    } | undefined;
+    legacyFileUploadUX?: boolean | undefined;
+    textFallbackWithoutTools?: boolean | undefined;
     endpoints?: Record<string, {
         disabled?: boolean | undefined;
         fileLimit?: number | undefined;
         fileSizeLimit?: number | undefined;
         totalSizeLimit?: number | undefined;
         supportedMimeTypes?: string[] | undefined;
+        defaultLLMDeliveryPath?: {
+            fallback?: "none" | "text" | "provider" | undefined;
+            overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+        } | undefined;
+        legacyFileUploadUX?: boolean | undefined;
+        textFallbackWithoutTools?: 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 +394,42 @@ export declare const fileConfigSchema: z.ZodObject<{
         maxHeight?: number | undefined;
         quality?: number | undefined;
     } | undefined;
-    ocr?: {
-        supportedMimeTypes?: string[] | undefined;
-    } | undefined;
 }, {
-    fileTokenLimit?: number | undefined;
     text?: {
         supportedMimeTypes?: string[] | undefined;
     } | undefined;
     skills?: {
         fileSizeLimit?: number | undefined;
+        importCleanupConcurrency?: number | undefined;
     } | undefined;
+    fileTokenLimit?: number | undefined;
+    ocr?: {
+        supportedMimeTypes?: string[] | undefined;
+    } | undefined;
+    defaultLLMDeliveryPath?: {
+        fallback?: "none" | "text" | "provider" | undefined;
+        overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+    } | undefined;
+    legacyFileUploadUX?: boolean | undefined;
+    textFallbackWithoutTools?: boolean | undefined;
     endpoints?: Record<string, {
         disabled?: boolean | undefined;
         fileLimit?: number | undefined;
         fileSizeLimit?: number | undefined;
         totalSizeLimit?: number | undefined;
         supportedMimeTypes?: string[] | undefined;
+        defaultLLMDeliveryPath?: {
+            fallback?: "none" | "text" | "provider" | undefined;
+            overrides?: Record<string, "none" | "text" | "provider"> | undefined;
+        } | undefined;
+        legacyFileUploadUX?: boolean | undefined;
+        textFallbackWithoutTools?: 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 +440,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. */
@@ -289,6 +448,12 @@ export declare const setFileConfigRegexCompiler: (compile: (pattern: string) =>
 export declare const convertStringsToRegex: (patterns: string[]) => RegexLike[];
 /** Detects whether the given MIME type patterns accept all file types (e.g., `.*` or `.+`). */
 export declare const isPermissiveMimeConfig: (types?: RegexLike[]) => boolean;
+/**
+ * Detects whether an endpoint's `supportedMimeTypes` were set by the admin rather than inherited
+ * from the built-in default list. Inheritance is signaled by referential identity with
+ * `supportedMimeTypes`, which `mergeWithDefault` preserves for unconfigured endpoints.
+ */
+export declare const isExplicitMimeConfig: (types?: RegexLike[]) => types is RegexLike[];
 /** The kind of content a provider upload path can actually send to the model. */
 export type MimeUploadCategory = 'image' | 'document' | 'audio' | 'video';
 /** Describes what an upload path can send, used to scope a configured allowlist to selectable files. */
@@ -298,6 +463,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.