librechat-data-provider 0.8.522 → 0.8.524

package/dist/types/types/content.d.ts

@@ -0,0 +1,286 @@
+import type { SubagentIdentity, ContentTypes } from './runs';
+import type { Agents } from './agents';
+import type { TFile } from './files';
+/**
+ * Details of the Code Interpreter tool call the run step was involved in.
+ * Includes the tool call ID, the code interpreter definition, and the type of tool call.
+ */
+export type CodeToolCall = {
+    id: string;
+    code_interpreter: {
+        input: string;
+        outputs: Array<Record<string, unknown>>;
+    };
+    type: 'code_interpreter';
+};
+/**
+ * Details of a Function tool call the run step was involved in.
+ * Includes the tool call ID, the function definition, and the type of tool call.
+ */
+export type FunctionToolCall = {
+    id: string;
+    function: {
+        arguments: string;
+        name: string;
+        output: string | null;
+    };
+    type: 'function';
+};
+/**
+ * Details of a Retrieval tool call the run step was involved in.
+ * Includes the tool call ID and the type of tool call.
+ */
+export type RetrievalToolCall = {
+    id: string;
+    retrieval: unknown;
+    type: 'retrieval';
+};
+/**
+ * Details of a Retrieval tool call the run step was involved in.
+ * Includes the tool call ID and the type of tool call.
+ */
+export type FileSearchToolCall = {
+    id: string;
+    file_search: unknown;
+    type: 'file_search';
+};
+/**
+ * Details of the tool calls involved in a run step.
+ * Can be associated with one of three types of tools: `code_interpreter`, `retrieval`, or `function`.
+ */
+export type ToolCallsStepDetails = {
+    tool_calls: Array<CodeToolCall | RetrievalToolCall | FileSearchToolCall | FunctionToolCall>;
+    type: 'tool_calls';
+};
+export type ImageFile = TFile & {
+    /**
+     * The [File](https://platform.openai.com/docs/api-reference/files) ID of the image
+     * in the message content.
+     */
+    file_id: string;
+    filename: string;
+    filepath: string;
+    height: number;
+    width: number;
+    /**
+     * Prompt used to generate the image if applicable.
+     */
+    prompt?: string;
+    /**
+     * Additional metadata used to generate or about the image/tool_call.
+     */
+    metadata?: Record<string, unknown>;
+};
+export type FileCitation = {
+    end_index: number;
+    file_citation: FileCitationDetails;
+    start_index: number;
+    text: string;
+    type: 'file_citation';
+};
+export type FileCitationDetails = {
+    file_id: string;
+    quote: string;
+};
+export type FilePath = {
+    end_index: number;
+    file_path: FilePathDetails;
+    start_index: number;
+    text: string;
+    type: 'file_path';
+};
+export type FilePathDetails = {
+    file_id: string;
+};
+export type Text = {
+    annotations?: Array<FileCitation | FilePath>;
+    value: string;
+};
+export declare enum AnnotationTypes {
+    FILE_CITATION = "file_citation",
+    FILE_PATH = "file_path"
+}
+export declare enum StepStatus {
+    IN_PROGRESS = "in_progress",
+    CANCELLED = "cancelled",
+    FAILED = "failed",
+    COMPLETED = "completed",
+    EXPIRED = "expired"
+}
+export declare enum MessageContentTypes {
+    TEXT = "text",
+    IMAGE_FILE = "image_file"
+}
+export type PartMetadata = {
+    /** Host-resolved execution identity for a saved subagent invocation. */
+    subagentIdentity?: SubagentIdentity;
+    progress?: number;
+    asset_pointer?: string;
+    status?: string;
+    action?: boolean;
+    auth?: string;
+    expires_at?: number;
+    /** Index indicating parallel sibling content (same stepIndex in multi-agent runs) */
+    siblingIndex?: number;
+    /** Agent ID for parallel agent rendering - identifies which agent produced this content */
+    agentId?: string;
+    /** Group ID for parallel content - parts with same groupId are displayed in columns */
+    groupId?: number;
+    /**
+     * Terminal lifecycle status of the run step that produced this part, from
+     * `on_run_step_closed`. Distinct from `status`, which is already claimed by
+     * activity-label and question-form parts. Absent on parts predating the
+     * event or from endpoints that do not emit it, in which case renderers fall
+     * back to inferring "stopped" from `progress` and `isSubmitting`.
+     */
+    runStepStatus?: Agents.RunStepClosedStatus;
+    /**
+     * Wall-clock milliseconds the run step took, derived from the same
+     * `on_run_step_closed` event as {@link runStepStatus} via
+     * `getRunStepDurationMs`. Only written when the event carried both
+     * timestamps and they agree in order — so its absence means "not
+     * derivable", never "instant". The raw value is persisted unfiltered;
+     * whether it is worth showing (`isReportableRunStepDuration`) is decided
+     * at render time.
+     */
+    runStepDurationMs?: number;
+    /**
+     * Stamped by the background harvester when a detached task's final output
+     * replaces the dispatch handle in `tool_call.output`. The handle JSON and
+     * the live status-marker attachment are both transient, so after the patch
+     * (or a reload) this is the only signal that the call ran in the
+     * background — renderers use it to keep treating {@link runStepDurationMs}
+     * as dispatch time rather than the task's runtime.
+     */
+    backgrounded?: boolean;
+    /**
+     * Content index this part occupied while its run streamed. The aggregator
+     * writes parts at provider-source indexes, so the streamed array is sparse;
+     * persistence compacts it and every part after a hole shifts down. The
+     * client's final handler stamps the streamed position onto the compacted
+     * parts it adopts, so index-derived render identity survives the swap
+     * instead of remounting the settled message. Client-only and absent
+     * everywhere else — persisted content never carries it.
+     */
+    streamedIndex?: number;
+};
+/** Metadata for parallel content rendering - subset of PartMetadata */
+export type ContentMetadata = Pick<PartMetadata, 'agentId' | 'groupId' | 'streamedIndex'>;
+export type ContentPart = (CodeToolCall | RetrievalToolCall | FileSearchToolCall | FunctionToolCall | Agents.AgentToolCall | ImageFile | Text) & PartMetadata;
+export type TextData = (Text & PartMetadata) | undefined;
+export type SummaryContentPart = {
+    type: ContentTypes.SUMMARY;
+    content?: Array<{
+        type: ContentTypes.TEXT;
+        text: string;
+    }>;
+    tokenCount?: number;
+    summarizing?: boolean;
+    /** A summarize round that ended in error. Partial deltas already streamed
+     *  into this slot are kept, so the renderer needs this to avoid presenting
+     *  truncated text under the "Conversation summarized" label. */
+    failed?: boolean;
+    /** Set when the user compacted the context manually rather than the
+     *  automatic detour firing on context pressure. */
+    initiatedBy?: 'user';
+    summaryVersion?: number;
+    model?: string;
+    provider?: string;
+    createdAt?: string;
+    boundary?: {
+        messageId: string;
+        contentIndex: number;
+    };
+};
+/**
+ * A user steering message injected mid-run at a tool-batch boundary.
+ * Persisted inline in the response message's content array (keyed by the
+ * type name like `text`/`think` so token counting reads it for free);
+ * replayed as a user message on subsequent turns by `formatAgentMessages`.
+ */
+export type SteerContentPart = {
+    type: ContentTypes.STEER;
+    steer: string;
+    steerId?: string;
+    /** Stable optimistic-client id used to settle a POST whose response was lost. */
+    clientSteerId?: string;
+    createdAt?: number;
+    /** Attachments steered with the message; re-encoded per turn on replay
+     *  like any other user-message media (refs only, never encoded data). */
+    files?: Partial<TFile>[];
+    /** Quoted excerpts steered with the message, persisted separately from the
+     *  typed text (mirroring `TMessage.quotes`) so the UI renders them as
+     *  reference blocks; merged into the model-bound user turn on every replay. */
+    quotes?: string[];
+};
+export type TMessageContentParts = ({
+    type: ContentTypes.ERROR;
+    text?: string | TextData;
+    error?: string;
+    /** Set when this failure is what a manual compaction produced instead of a
+     *  summary. The turn has no other record of having been one, so the rerun
+     *  controls read it the same way they read a summary's marker. */
+    initiatedBy?: 'user';
+} & ContentMetadata) | ({
+    type: ContentTypes.THINK;
+    think?: string | TextData;
+    /** Generated orientation for this user-visible reasoning step. */
+    reasoning_label?: string;
+    /** Stable SDK run-step identity used to correlate live revisions. */
+    reasoning_label_step_id?: string;
+    /** Durable provider-call count used to enforce the per-run cost cap across resumes. */
+    reasoning_label_attempts?: number;
+    /** Visible reasoning length included in this step's latest provider call. */
+    reasoning_label_submitted_chars?: number;
+    /** Monotonic provider-call revision; gaps are allowed after unsuccessful attempts. */
+    reasoning_label_revision?: number;
+    /** Whether the reasoning step can still produce a newer label. */
+    reasoning_label_status?: 'streaming' | 'complete';
+    /** The reasoning happened but its text is not available to this view
+     *  (e.g. detached subagent projections retain only a marker). */
+    reasoning_unavailable?: boolean;
+} & ContentMetadata) | (SteerContentPart & ContentMetadata) | ({
+    type: ContentTypes.TEXT;
+    text?: string | TextData;
+    tool_call_ids?: string[];
+    /** Open Responses semantic channel for assistant text. */
+    phase?: 'commentary' | 'final_answer';
+} & ContentMetadata) | ({
+    type: ContentTypes.TOOL_CALL;
+    tool_call: (CodeToolCall | RetrievalToolCall | FileSearchToolCall | FunctionToolCall | Agents.AgentToolCall) & PartMetadata;
+} & ContentMetadata) | ({
+    type: ContentTypes.IMAGE_FILE;
+    image_file: ImageFile & PartMetadata;
+} & ContentMetadata) | (SummaryContentPart & ContentMetadata) | ({
+    /** One-line LLM-generated note describing a completed tool batch. UI-only:
+     *  never sent to the model (stripped before payload formatting). */
+    type: ContentTypes.ACTIVITY_LABEL;
+    activity_label?: string;
+    /** Missing means the legacy/per-batch activity label. */
+    activity_label_type?: 'phase';
+    tool_call_ids?: string[];
+    /** Parent phase bounds and telemetry. */
+    activity_start_index?: number;
+    /** Exclusive end of the grouped content; may precede the marker itself. */
+    activity_end_index?: number;
+    activity_count?: number;
+    agent_ids?: string[];
+    /** ok = all tools succeeded, failed = all failed, partial = mixed. */
+    status?: 'ok' | 'partial' | 'failed';
+    pending?: boolean;
+} & ContentMetadata) | (Agents.AgentUpdate & ContentMetadata) | (Agents.MessageContentImageUrl & ContentMetadata) | (Agents.MessageContentVideoUrl & ContentMetadata) | (Agents.MessageContentInputAudio & ContentMetadata);
+export type StreamContentData = TMessageContentParts & {
+    /** The index of the current content part */
+    index: number;
+    /** The current text content was already served but edited to replace elements therein */
+    edited?: boolean;
+};
+export type TContentData = StreamContentData & {
+    messageId: string;
+    conversationId: string;
+    userMessageId: string;
+    thread_id: string;
+    stream?: boolean;
+};
+export declare const hostImageIdSuffix = "_host_copy";
+export declare const hostImageNamePrefix = "host_copy_";

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

@@ -1,5 +1,6 @@
+import type { TDefaultLLMDeliveryPathConfig } from '../file-config';
 import type { CodeEnvRef, CodeEnvRefMap } from '../codeEnvRef';
-import { EToolResources } from './assistants';
+import { EToolResources } from './tools';
 export declare enum FileSources {
     local = "local",
     firebase = "firebase",
@@ -26,6 +27,7 @@ export declare enum FileContext {
     image_generation = "image_generation",
     assistants_output = "assistants_output",
     message_attachment = "message_attachment",
+    run_artifact = "run_artifact",
     skill_file = "skill_file",
     filename = "filename",
     updatedAt = "updatedAt",
@@ -44,15 +46,26 @@ export type EndpointFileConfig = {
     fileSizeLimit?: number;
     totalSizeLimit?: number;
     supportedMimeTypes?: RegexLike[];
+    defaultLLMDeliveryPath?: TDefaultLLMDeliveryPathConfig;
+    legacyFileUploadUX?: boolean;
+    /** Delivers the text extracted at upload for a file routed to tools (`none`) on a turn that
+     *  runs no tool able to read it. Off by default, which leaves such a file out of the prompt. */
+    textFallbackWithoutTools?: boolean;
 };
 export type FileConfig = {
     endpoints: {
         [key: string]: EndpointFileConfig;
     };
     skills?: {
+        /** Maximum concurrent blob deletions during failed archive import cleanup. */
+        importCleanupConcurrency?: number;
         fileSizeLimit?: number;
     };
     fileTokenLimit?: number;
+    /** Maximum aggregate model-bound attachment bytes admitted into one agent turn. */
+    fileContextSizeLimit?: number;
+    /** Maximum aggregate extracted-text characters admitted into one agent turn. */
+    fileContextCharLimit?: number;
     serverFileSizeLimit?: number;
     avatarSizeLimit?: number;
     clientImageResize?: {
@@ -73,16 +86,25 @@ export type FileConfig = {
         supportedMimeTypes?: RegexLike[];
     };
     checkType?: (fileType: string, supportedTypes: RegexLike[]) => boolean;
+    defaultLLMDeliveryPath?: TDefaultLLMDeliveryPathConfig;
+    legacyFileUploadUX?: boolean;
+    /** Delivers the text extracted at upload for a file routed to tools (`none`) on a turn that
+     *  runs no tool able to read it. Off by default, which leaves such a file out of the prompt. */
+    textFallbackWithoutTools?: boolean;
 };
 export type FileConfigInput = {
     endpoints?: {
         [key: string]: EndpointFileConfig;
     };
     skills?: {
+        /** Maximum concurrent blob deletions during failed archive import cleanup. */
+        importCleanupConcurrency?: number;
         fileSizeLimit?: number;
     };
     serverFileSizeLimit?: number;
     avatarSizeLimit?: number;
+    fileContextSizeLimit?: number;
+    fileContextCharLimit?: number;
     clientImageResize?: {
         enabled?: boolean;
         maxWidth?: number;
@@ -99,6 +121,23 @@ export type FileConfigInput = {
         supportedMimeTypes?: string[];
     };
     checkType?: (fileType: string, supportedTypes: RegexLike[]) => boolean;
+    defaultLLMDeliveryPath?: TDefaultLLMDeliveryPathConfig;
+    legacyFileUploadUX?: boolean;
+    /** Delivers the text extracted at upload for a file routed to tools (`none`) on a turn that
+     *  runs no tool able to read it. Off by default, which leaves such a file out of the prompt. */
+    textFallbackWithoutTools?: boolean;
+};
+/** The immutable origin of a file explicitly published from an agent execution. */
+export type RunFileProvenance = {
+    runId: string;
+    executionId: string;
+    agentId: string;
+    parentExecutionId?: string;
+    parentAgentId?: string;
+    recipientAgentIds?: string[];
+    sourceFileId: string;
+    publishedAt: string;
+    inputFileIds: string[];
 };
 export type TFile = {
     _id?: string;
@@ -150,6 +189,7 @@ export type TFile = {
      */
     previewError?: string;
     metadata?: {
+        runFile?: RunFileProvenance;
         fileIdentifier?: string;
         /**
          * Structured form of `fileIdentifier`. Persisted alongside the
@@ -160,7 +200,14 @@ export type TFile = {
         codeEnvRefs?: CodeEnvRefMap;
         /** Dispatch-order stamp for the current source artifact generation. */
         sourceDispatchedAt?: number;
+        /** Vector namespaces this file has been embedded into. */
+        embeddedEntities?: string[];
+        /** The user named this destination, so absent ones were declined. */
+        destinationChosen?: boolean;
+        /** The type the delivery route was resolved against, when conversion changed it. */
+        routingMimeType?: string;
     };
+    llmDeliveryPath?: 'provider' | 'text' | 'none';
     createdAt?: string | Date;
     updatedAt?: string | Date;
 };

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

@@ -2,15 +2,21 @@ 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 declare const INSIGHTS_AGENT_ID_MAX_LENGTH = 256;
 export type TInsightsParams = {
     range?: InsightsRange;
     fromTimestamp?: string;
     toTimestamp?: string;
     timeZone?: string;
     search?: string;
+    agentIds?: string[];
     page?: number;
     pageSize?: number;
 };
+export type TInsightsAgent = {
+    id: string;
+    name: string;
+};
 export type TInsightsDailyPoint = {
     date: string;
     conversations: number;
@@ -31,6 +37,8 @@ export type TInsightsChurnedUser = TInsightsUser & {
 };
 export type TInsightsConversation = {
     conversationId: string;
+    agentId: string;
+    agentName: string;
     date: string;
     userId: string;
     name: string;
@@ -46,6 +54,7 @@ export type TInsightsSummary = {
     totalTokens: number;
 };
 export type TInsightsResponse = {
+    agents: TInsightsAgent[];
     summary: TInsightsSummary;
     daily: TInsightsDailyPoint[];
     topUsers: TInsightsUser[];

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

@@ -1,7 +1,8 @@
 import type { InfiniteData, QueryKey } from '@tanstack/react-query';
 import type { TSkill, TSkillFile, TCreateSkill, TUpdateSkillVariables, TUpdateSkillResponse, TDeleteSkillResponse, TUploadSkillFileVariables, TDeleteSkillFileVariables, TDeleteSkillFileResponse, TSkillListResponse } from './skills';
-import { Tools, Assistant, AssistantCreateParams, AssistantUpdateParams, FunctionTool, AssistantDocument, Agent, AgentCreateParams, AgentUpdateParams } from './assistants';
-import { Action, ActionMetadata } from './agents';
+import { Assistant, AssistantCreateParams, AssistantUpdateParams, AssistantDocument } from './assistants';
+import { Action, ActionMetadata, Agent, AgentCreateParams, AgentUpdateParams } from './agents';
+import { Tools, FunctionTool } from './tools';
 import * as p from '../permissions';
 import * as types from '../types';
 import * as r from '../roles';

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

@@ -22,7 +22,7 @@ export type ConversationListParams = {
     search?: string;
     projectId?: string;
 };
-export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'archivedAt' | 'user' | 'chatProjectId' | 'pinned'>;
+export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'archivedAt' | 'isArchived' | 'user' | 'chatProjectId' | 'pinned'>;
 export type ConversationListResponse = {
     conversations: MinimalConversation[];
     nextCursor: string | null;
@@ -103,6 +103,10 @@ export type MCPServer = {
     name: string;
     icon: string;
     authenticated: boolean;
+    /** Passive discovery found that stored OAuth authorization must be renewed. */
+    authorizationState?: 'reauth_required';
+    /** Shared credential/catalog generation observed by passive discovery. */
+    authorizationGeneration?: string;
     authConfig: s.TPluginAuthConfig[];
     tools: MCPTool[];
 };
@@ -194,6 +198,8 @@ export interface MCPServerStatus {
     configurationState?: 'configured' | 'needs_configuration';
     connectionState: 'disconnected' | 'connecting' | 'connected' | 'error';
     authorizationState?: 'not_required' | 'authorizing' | 'authorized' | 'needs_authorization' | 'error';
+    /** Shared credential/catalog generation observed by the status endpoint. */
+    authorizationGeneration?: string;
 }
 export interface MCPConnectionStatusResponse {
     success: boolean;
@@ -209,6 +215,7 @@ export interface MCPServerConnectionStatusResponse {
     configurationState?: MCPServerStatus['configurationState'];
     connectionStatus: 'disconnected' | 'connecting' | 'connected' | 'error';
     authorizationState?: MCPServerStatus['authorizationState'];
+    authorizationGeneration?: string;
 }
 export interface MCPAuthValuesResponse {
     success: boolean;