librechat-data-provider 0.8.509 → 0.8.522

package/dist/types/types/subagents.d.ts

@@ -0,0 +1,159 @@
+export type SubagentThreadStatus = 'dispatched' | 'running' | 'completed' | 'failed' | 'interrupted' | 'cancelled';
+export type ParentSubagentTaskSummary = {
+    taskId: string;
+    status: SubagentThreadStatus;
+    createdAt?: string;
+};
+/**
+ * Bounded discovery projection for one child owned by a parent conversation.
+ * Event-delivery identities stay private; `actorId` is the only event-binding
+ * field intentionally exposed to the parent's UI.
+ */
+export type ParentSubagentSummary = {
+    threadId: string;
+    parentMessageId: string;
+    /** Present only for ordinary tool-spawned children. */
+    parentToolCallId?: string;
+    subagentType: string;
+    subagentKind: 'agent' | 'graph';
+    agentId?: string;
+    title: string;
+    origin: 'tool' | 'event';
+    actorId?: string;
+    status: SubagentThreadStatus;
+    updatedAt?: string;
+    latestTaskId?: string;
+    tasks: ParentSubagentTaskSummary[];
+    tasksTruncated: boolean;
+};
+export type ParentSubagentIndex = {
+    parentConversationId: string;
+    children: ParentSubagentSummary[];
+    childrenTruncated: boolean;
+};
+/**
+ * A bounded, presentation-safe description of child work. This deliberately
+ * models user-visible activity instead of the LangChain messages, SSE events,
+ * or durable records that produced it.
+ */
+export type SubagentActivityItem = {
+    type: 'writing';
+    text: string;
+    textTruncated?: boolean;
+} | {
+    type: 'reasoning';
+    /** Bounded user-visible reasoning text; absent on projections persisted
+     *  before reasoning retention (rendered as a marker). */
+    text?: string;
+    textTruncated?: boolean;
+} | {
+    type: 'activity_label';
+    label: string;
+    labelType?: 'phase';
+    toolCallIds?: string[];
+    activityStartIndex?: number;
+    activityEndIndex?: number;
+    activityCount?: number;
+    agentIds?: string[];
+    status?: 'ok' | 'partial' | 'failed';
+    pending?: boolean;
+    labelTruncated?: boolean;
+} | {
+    type: 'tool';
+    toolCallId: string;
+    name: string;
+    input?: string;
+    output?: string;
+    status: 'running' | 'completed' | 'failed' | 'cancelled';
+    inputValidationError?: true;
+    inputTruncated?: boolean;
+    outputTruncated?: boolean;
+};
+export type SubagentControlAction = 'steer' | 'queue' | 'interrupt' | 'cancel' | 'cancel_message';
+export type SubagentControlReceipt = {
+    invocationId: string;
+    controlId?: string;
+    action: SubagentControlAction;
+    status: 'accepted' | 'applied' | 'rejected' | 'failed';
+    createdAt: string;
+    updatedAt: string;
+    boundary?: 'preempt' | 'tool' | 'turn';
+    reason?: string;
+    message?: string;
+    messageTruncated?: boolean;
+};
+export type SubagentControlRequest = {
+    taskId: string;
+    invocationId: string;
+    action: SubagentControlAction;
+    message?: string;
+    controlId?: string;
+};
+export type SubagentControlResponse = {
+    receipt: SubagentControlReceipt;
+};
+export type SubagentThreadMessage = {
+    messageId: string;
+    parentMessageId: string | null;
+    role: 'user' | 'assistant';
+    text: string;
+    createdAt?: string;
+    error?: boolean;
+    textTruncated?: boolean;
+};
+export type SubagentThreadTriggerKind = 'parent_dispatch' | 'parent_continuation' | 'external_event';
+export type SubagentExternalEventDetails = {
+    eventType: string;
+    sourceType: string;
+    occurredAt: string;
+    expectedActionToolName?: string;
+};
+/**
+ * One chronological child execution boundary. The trigger is host-authored,
+ * while activity and messages are bounded public projections of the child run.
+ */
+export type SubagentThreadTurn = {
+    taskId: string;
+    trigger: {
+        kind: SubagentThreadTriggerKind;
+        summary: string;
+        createdAt?: string;
+        summaryTruncated?: boolean;
+        externalEvent?: SubagentExternalEventDetails;
+    };
+    status: SubagentThreadStatus;
+    activity: SubagentActivityItem[];
+    activityTruncated: boolean;
+    controlReceipts?: SubagentControlReceipt[];
+    controlReceiptsTruncated?: boolean;
+    messages: SubagentThreadMessage[];
+};
+export type SubagentThreadView = {
+    threadId: string;
+    parentConversationId: string;
+    parentMessageId: string;
+    parentToolCallId: string;
+    subagentType: string;
+    subagentKind: 'agent' | 'graph';
+    /** Product recursion level, currently bounded to one by the host runtime. */
+    depth?: number;
+    agentId?: string;
+    title: string;
+    status: SubagentThreadStatus;
+    /** Activity for the exact task requested by the parent card, when retained. */
+    activity: SubagentActivityItem[];
+    activityTruncated: boolean;
+    /** Bounded authoritative parent-to-child command receipts for this task. */
+    controlReceipts?: SubagentControlReceipt[];
+    /** True when older authoritative command receipts were omitted from this view. */
+    controlReceiptsTruncated?: boolean;
+    /** Chronological, branch-selected child history for conversation-native rendering. */
+    turns?: SubagentThreadTurn[];
+    messages: SubagentThreadMessage[];
+    historyTruncated: boolean;
+    /** True when some branch rows were omitted and cannot be recovered with `nextCursor`. */
+    historyUnavailable?: boolean;
+    /** Opaque task-message cursor for the next older bounded branch page. */
+    nextCursor?: string;
+    updatedAt?: string;
+};

package/dist/types/types/web.d.ts

@@ -9,8 +9,8 @@ export declare enum DATE_RANGE {
     PAST_MONTH = "m",
     PAST_YEAR = "y"
 }
-export type SearchProvider = 'serper' | 'searxng' | 'tavily';
-export type ScraperProvider = 'firecrawl' | 'serper' | 'tavily';
+export type SearchProvider = 'serper' | 'searxng' | 'tavily' | 'keenable';
+export type ScraperProvider = 'firecrawl' | 'serper' | 'tavily' | 'keenable';
 export type RerankerType = 'infinity' | 'jina' | 'cohere' | 'none';
 export interface Highlight {
     score: number;
@@ -68,9 +68,13 @@ export interface SearchConfig {
     serperApiKey?: string;
     searxngInstanceUrl?: string;
     searxngApiKey?: string;
+    searxngSearchOptions?: z.infer<typeof webSearchSchema>['searxngSearchOptions'];
     tavilyApiKey?: string;
     tavilySearchUrl?: string;
     tavilySearchOptions?: TavilyConfig['tavilySearchOptions'];
+    keenableApiKey?: string;
+    keenableApiUrl?: string;
+    keenableSearchOptions?: KeenableConfig['keenableSearchOptions'];
 }
 export type References = {
     links: MediaReference[];
@@ -130,6 +134,12 @@ export interface TavilyConfig {
     tavilySearchOptions?: z.infer<typeof webSearchSchema>['tavilySearchOptions'];
     tavilyScraperOptions?: z.infer<typeof webSearchSchema>['tavilyScraperOptions'];
 }
+export interface KeenableConfig {
+    keenableApiKey?: string;
+    keenableApiUrl?: string;
+    keenableSearchOptions?: z.infer<typeof webSearchSchema>['keenableSearchOptions'];
+    keenableScraperOptions?: z.infer<typeof webSearchSchema>['keenableScraperOptions'];
+}
 export interface ScraperContentResult {
     content: string;
 }

package/dist/types/types.d.ts

@@ -1,11 +1,14 @@
 import type { InfiniteData } from '@tanstack/react-query';
 import type { TConversationTag, EModelEndpoint, TConversation, TSharedLink, TAttachment, TMessage, TBanner, ReasoningResponseKey, ReasoningParameterFormat } from './schemas';
+import type { CodeEnvironmentUserConfigSchema, CodeEnvironmentUserSettings } from './config';
+import type { Agent, EToolResources, StatefulCodeEnvironment } from './types/assistants';
 import type { RefillIntervalUnit } from './balance';
 import type { SettingDefinition } from './generate';
 import type { TMinimalFeedback } from './feedback';
 import type { ContentTypes } from './types/runs';
-import type { Agent } from './types/assistants';
+import type { ProviderId } from './providers';
 export * from './schemas';
+export * from './types/subagents';
 export type TMessages = TMessage[];
 export type TEndpointOption = Pick<TConversation, 'endpoint' | 'endpointType' | 'model' | 'modelLabel' | 'chatGptLabel' | 'promptPrefix' | 'temperature' | 'topP' | 'topK' | 'top_p' | 'frequency_penalty' | 'presence_penalty' | 'maxOutputTokens' | 'maxContextTokens' | 'max_tokens' | 'maxTokens' | 'resendFiles' | 'imageDetail' | 'reasoning_effort' | 'verbosity' | 'instructions' | 'additional_instructions' | 'append_current_datetime' | 'tools' | 'stop' | 'region' | 'additionalModelRequestFields' | 'promptCache' | 'promptCacheTtl' | 'thinking' | 'thinkingBudget' | 'thinkingLevel' | 'effort' | 'thinkingDisplay' | 'assistant_id' | 'agent_id' | 'iconURL' | 'greeting' | 'spec' | 'artifacts' | 'file_ids' | 'system' | 'chatProjectId' | 'examples' | 'context'> & {
     modelDisplayLabel?: string;
@@ -29,6 +32,21 @@ export type TEphemeralAgent = {
     execute_code?: boolean;
     artifacts?: string;
     skills?: boolean;
+    memory?: boolean;
+    /** Equip the ephemeral agent with the `ask_user_question` HITL tool. */
+    ask_user_question?: boolean;
+    /**
+     * Let the model dispatch this ephemeral agent's eligible tool calls in the
+     * background (poll results via `check_background_task`). Requires the
+     * `run_in_background` agent capability to be enabled by the admin.
+     */
+    run_in_background?: boolean;
+    /**
+     * Inject the `intent` label param into this ephemeral agent's eligible
+     * tools so each call streams a live status label. Requires the
+     * `tool_intents` agent capability to be enabled by the admin.
+     */
+    describe_intent?: boolean;
 };
 export type TPayload = Partial<TMessage> & Partial<TEndpointOption> & {
     isContinued: boolean;
@@ -49,6 +67,21 @@ export type TPayload = Partial<TMessage> & Partial<TEndpointOption> & {
     manualSkills?: string[];
     /** Browser IANA timezone (e.g. `America/New_York`) used to resolve local-time prompt variables server-side. */
     timezone?: string;
+    /**
+     * Stable per-submission idempotency key (uuid) generated once per `ask()`. Identical
+     * across the client's start-generation network retries, unique per user action (including
+     * regenerate). The server dedups retried start requests on it so a lost/reset response
+     * cannot trigger a second billed generation.
+     */
+    clientRequestId?: string;
+    /** Parked steer source consumed only after this new turn's user message is
+     * durably saved. Separate from `clientRequestId`, which identifies one
+     * generation attempt and must rotate after a failed recovery. */
+    recoverySteerId?: string;
+    /** Optional optimistic-serialization fence for a queued follow-up. The
+     * server may create only if this observed predecessor is still current or
+     * the conversation is still idle after its cleanup. */
+    expectedPredecessorCreatedAt?: number;
 };
 export type TEditedContent = {
     index: number;
@@ -74,10 +107,44 @@ export type TSubmission = {
     clientTimestamp?: string;
     ephemeralAgent?: TEphemeralAgent | null;
     editedContent?: TEditedContent | null;
+    /**
+     * Length of the retained content prefix for an edited resubmission, captured
+     * when the submission is built.
+     *
+     * The server indexes only NEW content, so the client offsets incoming
+     * indices by the prefix it kept. `initialResponse.content` cannot be used
+     * for that after a reconnect: the resume sync overwrites it with the
+     * server's completion-local snapshot, whose length is unrelated to the
+     * prefix. Recording the length up front keeps the offset stable across
+     * resumes for run steps and activity labels alike.
+     */
+    editPrefixLength?: number;
+    /** True once server index 0 text/reasoning actually merged into the retained tail. */
+    editPrefixFirstPartFolded?: boolean;
+    /**
+     * Set once a resume SYNC has replaced the response's retained prefix with
+     * the server's completion-local snapshot. From that point the prefix is
+     * gone from the rendered message and server indices are absolute in the
+     * new space, so {@link editPrefixLength} must NOT be applied — by run
+     * steps or by activity labels. Both event paths read this flag so a
+     * batch's tool cards and its header always land in one index space.
+     *
+     * Stamped per event by the resumable transport, which owns the SYNC
+     * boundary; the non-resumable path never sets it.
+     */
+    editPrefixCleared?: boolean;
     /** Added conversation for multi-convo feature */
     addedConvo?: TConversation;
     /** Skills the user invoked via the `$` popover for this submission. */
     manualSkills?: string[];
+    /** Stable per-submission idempotency key (uuid) forwarded to the server to dedup retried start-generation requests. */
+    clientRequestId?: string;
+    /** Client-only carry-through for a receipt-bound queued recovery. */
+    recoverySteerId?: string;
+    expectedPredecessorCreatedAt?: number;
+    /** Opaque client-only queue restoration metadata; intentionally omitted by
+     * `createPayload`. */
+    queuedMessageOrigin?: unknown;
 };
 export type EventSubmission = Omit<TSubmission, 'initialResponse'> & {
     initialResponse: TMessage;
@@ -108,6 +175,8 @@ export type TMarketplaceCategory = TCategory & {
 export type TError = {
     message: string;
     code?: number | string;
+    file_id?: string;
+    tool_resource?: EToolResources;
     response?: {
         data?: {
             message?: string;
@@ -134,10 +203,18 @@ export type TUser = {
     backupCodes?: TBackupCode[];
     personalization?: {
         memories?: boolean;
+        statefulCodeEnvironment?: StatefulCodeEnvironment;
     };
     createdAt: string;
     updatedAt: string;
 };
+export type TUpdateUserPreferencesRequest = {
+    statefulCodeEnvironment: StatefulCodeEnvironment;
+};
+export type TUpdateUserPreferencesResponse = {
+    updated: boolean;
+    preferences: TUpdateUserPreferencesRequest;
+};
 export type TGetConversationsResponse = {
     conversations: TConversation[];
     pageNumber: string;
@@ -239,6 +316,9 @@ export type TArchiveConversationRequest = {
     isArchived: boolean;
 };
 export type TArchiveConversationResponse = TConversation;
+export type TArchiveAllConversationsResponse = {
+    archivedCount: number;
+};
 export type TPinConversationRequest = {
     conversationId: string;
     pinned: boolean;
@@ -246,6 +326,7 @@ export type TPinConversationRequest = {
 export type TPinConversationResponse = TConversation;
 export type TSharedMessagesResponse = Omit<TSharedLink, 'messages'> & {
     messages: TMessage[];
+    langfuseSessionUrl?: string;
 };
 export type TCreateShareLinkRequest = Pick<TConversation, 'conversationId'>;
 export type TUpdateShareLinkRequest = Pick<TSharedLink, 'shareId' | 'targetMessageId'>;
@@ -287,6 +368,17 @@ export type TForkConvoResponse = {
     conversation: TConversation;
     messages: TMessage[];
 };
+export type TForkSharedConvoRequest = {
+    shareId: string;
+    /** Index of the viewer's active message within the shared payload; reduces the
+     *  fork to that branch. An index is used because shared ids are re-anonymized
+     *  per request and `createdAt` can collide, while the payload order is stable. */
+    targetMessageIndex?: number;
+    /** `updatedAt` of the shared payload being forked. The shareId survives an
+     *  owner update, so the server rejects a fork whose payload has since moved
+     *  instead of resolving the index against different messages. */
+    shareRevision?: string;
+};
 export type TSearchResults = {
     conversations: TConversation[];
     messages: TMessage[];
@@ -295,6 +387,43 @@ export type TSearchResults = {
     pages: string | number;
     filter: object;
 };
+export type TPublicCodeEnvironment = {
+    id: string;
+    name: string;
+    type: 'managed' | 'attached';
+    default?: boolean;
+    pairingAvailable?: boolean;
+    configSchema?: CodeEnvironmentUserConfigSchema;
+    settings?: CodeEnvironmentUserSettings;
+};
+export type TCodeEnvironmentSummary = {
+    resourceId: string;
+    id: string;
+    name: string;
+    type: 'managed' | 'attached';
+    canEdit?: boolean;
+    canDelete: boolean;
+    configSchema?: CodeEnvironmentUserConfigSchema;
+    settings?: CodeEnvironmentUserSettings;
+};
+export type TCodeControlPlane = {
+    id: string;
+    name: string;
+    configSchema?: CodeEnvironmentUserConfigSchema;
+};
+export type TCodeEnvironmentsResponse = {
+    environments: TCodeEnvironmentSummary[];
+    controlPlanes: TCodeControlPlane[];
+};
+export type TCodeEnvironmentPairingResponse = {
+    environment: TCodeEnvironmentSummary;
+    pairing: {
+        workerId: string;
+        code: string;
+        expiresAt: string;
+        endpoint: string;
+    };
+};
 export type TConfig = {
     order: number;
     type?: EModelEndpoint;
@@ -305,6 +434,8 @@ export type TConfig = {
     plugins?: Record<string, string>;
     name?: string;
     iconURL?: string;
+    /** Canonical provider identity resolved at config load, used for branding. */
+    providerId?: ProviderId;
     version?: string;
     modelDisplayLabel?: string;
     userProvide?: boolean | null;
@@ -316,6 +447,12 @@ export type TConfig = {
     disableBuilder?: boolean;
     retrievalModels?: string[];
     capabilities?: string[];
+    statefulCodeSessions?: {
+        allowedEnvironments: StatefulCodeEnvironment[];
+        environments?: TPublicCodeEnvironment[];
+    };
+    /** Effective subagents-per-agent cap served from `endpoints.agents.maxSubagents`. */
+    maxSubagents?: number;
     customParams?: {
         defaultParamsEndpoint?: string;
         reasoningFormat?: ReasoningParameterFormat;
@@ -557,9 +694,11 @@ export type TCustomConfigSpeechResponse = {
 };
 export type TUserTermsResponse = {
     termsAccepted: boolean;
+    termsAcceptedAt: Date | string | null;
 };
 export type TAcceptTermsResponse = {
-    success: boolean;
+    message: string;
+    termsAcceptedAt: Date | string;
 };
 export type TBannerResponse = TBanner | null;
 export type TUpdateFeedbackRequest = {
@@ -621,3 +760,37 @@ export type TUpdateSkillNodeRequest = {
     parentId?: string | null;
     order?: number;
 };
+export type TLangfuseConnectionStatus = {
+    configured: boolean;
+    enabled: boolean;
+    destinations: TLangfuseDestinationOption[];
+    destination?: string;
+    publicKey?: string;
+    secretKeyPreview?: string;
+    updatedAt?: string;
+};
+export type TLangfuseDestinationOption = {
+    key: string;
+    baseUrl: string;
+};
+export type TUpdateLangfuseConnectionRequest = {
+    enabled: boolean;
+    destination: string;
+    publicKey: string;
+    secretKey?: string;
+};
+export type TLangfuseConnectionTestRequest = {
+    destination: string;
+    publicKey: string;
+    secretKey?: string;
+};
+export type TLangfuseConnectionTestErrorCode = 'invalid_credentials' | 'access_denied' | 'rate_limited' | 'server_error' | 'timeout' | 'unreachable' | 'missing_secret' | 'stored_secret_unavailable' | 'unexpected_response';
+export type TLangfuseConnectionTestResponse = {
+    success: true;
+} | {
+    success: false;
+    errorCode: TLangfuseConnectionTestErrorCode;
+};
+export type TLangfuseSessionLinkResponse = {
+    url: string | null;
+};

package/dist/types/upload.d.ts

@@ -0,0 +1,2 @@
+import type { TFileUpload } from './types/files';
+export declare function uploadEventStream(url: string, formData: FormData, signal?: AbortSignal | null): Promise<TFileUpload>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "librechat-data-provider",
-  "version": "0.8.509",
+  "version": "0.8.522",
   "description": "data services for librechat apps",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -43,9 +43,11 @@
   },
   "homepage": "https://librechat.ai",
   "dependencies": {
-    "axios": "^1.16.0",
+    "axios": "^1.20.0",
+    "croner": "^10.0.1",
     "dayjs": "^1.11.13",
-    "js-yaml": "^4.2.0",
+    "js-yaml": "^4.3.1",
+    "re2js": "^2.8.6",
     "zod": "^3.22.4"
   },
   "devDependencies": {
@@ -61,14 +63,14 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.12.4",
     "@types/react": "^18.2.18",
-    "@types/winston": "^2.4.4",
     "jest": "^30.2.0",
     "jest-junit": "^17.0.0",
     "openapi-types": "^12.1.3",
     "rimraf": "^6.1.3",
     "rollup": "^4.34.9",
     "tsdown": "^0.22.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "winston": "^3.17.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^4.28.0"