librechat-data-provider 0.8.503 → 0.8.505

package/dist/types/types/agents.d.ts

@@ -1,6 +1,7 @@
-import { StepTypes, ContentTypes, ToolCallTypes } from './runs';
 import type { FunctionToolCall, SummaryContentPart } from './assistants';
+import type { TTokenUsageEvent, TContextUsageEvent } from './runs';
 import type { TAttachment, TPlugin } from 'src/schemas';
+import { StepTypes, ContentTypes, ToolCallTypes } from './runs';
 export declare namespace Agents {
     type MessageType = 'human' | 'ai' | 'generic' | 'system' | 'function' | 'tool' | 'remove';
     type ImageDetail = 'auto' | 'low' | 'high';
@@ -188,6 +189,24 @@ export declare namespace Agents {
         responseMessageId?: string;
         conversationId?: string;
         sender?: string;
+        iconURL?: string;
+        model?: string;
+        titleEvent?: {
+            event: 'title';
+            data?: {
+                conversationId?: string;
+                title?: string;
+            };
+        };
+        replayEvents?: Array<{
+            event: string;
+            data?: unknown;
+            [key: string]: unknown;
+        }>;
+        /** Cumulative provider-reported usage for the run; backfills usage totals on resume */
+        collectedUsage?: TTokenUsageEvent[];
+        /** Latest context window snapshot; restores the usage gauge on resume */
+        contextUsage?: TContextUsageEvent;
     }
     /**
      * Represents a run step delta i.e. any changed fields on a run step during

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

@@ -16,7 +16,7 @@ export declare enum FileSources {
     text = "text",
     document_parser = "document_parser"
 }
-export declare const checkOpenAIStorage: (source: string) => boolean;
+export declare const checkOpenAIStorage: (source: string) => source is FileSources.azure | FileSources.openai;
 export declare enum FileContext {
     avatar = "avatar",
     unknown = "unknown",

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

@@ -17,14 +17,27 @@ export type ConversationListParams = {
     sortDirection?: 'asc' | 'desc';
     tags?: string[];
     search?: string;
+    projectId?: string;
 };
-export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'user'>;
+export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'user' | 'chatProjectId'>;
 export type ConversationListResponse = {
     conversations: MinimalConversation[];
     nextCursor: string | null;
 };
 export type ConversationData = InfiniteData<ConversationListResponse>;
 export type ConversationUpdater = (data: ConversationData, conversation: s.TConversation) => ConversationData;
+export type ProjectListParams = {
+    cursor?: string;
+    limit?: number;
+    sortBy?: 'name' | 'createdAt' | 'lastConversationAt';
+    sortDirection?: 'asc' | 'desc';
+    search?: string;
+};
+export type ProjectListResponse = {
+    projects: t.TChatProject[];
+    nextCursor: string | null;
+};
+export type ProjectData = InfiniteData<ProjectListResponse>;
 export type MessagesListParams = {
     cursor?: string | null;
     sortBy?: 'endpoint' | 'createdAt' | 'updatedAt';
@@ -43,7 +56,6 @@ export type SharedMessagesResponse = Omit<s.TSharedLink, 'messages'> & {
 };
 export interface SharedLinksListParams {
     pageSize: number;
-    isPublic: boolean;
     sortBy: 'title' | 'createdAt';
     sortDirection: 'asc' | 'desc';
     search?: string;
@@ -52,7 +64,6 @@ export interface SharedLinksListParams {
 export type SharedLinkItem = {
     shareId: string;
     title: string;
-    isPublic: boolean;
     createdAt: Date;
     conversationId: string;
 };
@@ -156,6 +167,8 @@ export interface MCPServerStatus {
 export interface MCPConnectionStatusResponse {
     success: boolean;
     connectionStatus: Record<string, MCPServerStatus>;
+    /** Server-configured OAuth completion window in ms (`MCP_OAUTH_HANDLING_TIMEOUT`) */
+    oauthTimeout?: number;
 }
 export interface MCPServerConnectionStatusResponse {
     success: boolean;

package/dist/types/types/runs.d.ts

@@ -35,6 +35,87 @@ export declare enum StepEvents {
     ON_SUMMARIZE_COMPLETE = "on_summarize_complete",
     ON_SUBAGENT_UPDATE = "on_subagent_update"
 }
+/** Token-tracking event names streamed to the client (separate from StepEvents dispatch). */
+export declare enum UsageEvents {
+    ON_CONTEXT_USAGE = "on_context_usage",
+    ON_TOKEN_USAGE = "on_token_usage"
+}
+/** Mirrors TokenBudgetBreakdown from @librechat/agents (data-provider cannot import it). */
+export type TTokenBudgetBreakdown = {
+    maxContextTokens: number;
+    instructionTokens: number;
+    systemMessageTokens: number;
+    dynamicInstructionTokens: number;
+    toolSchemaTokens: number;
+    summaryTokens: number;
+    toolCount: number;
+    messageCount: number;
+    messageTokens: number;
+    availableForMessages: number;
+    /** Per-tool schema token counts (post-multiplier), keyed by tool name */
+    toolTokenCounts?: Record<string, number>;
+    /** Names of counted tools that are deferred (`defer_loading`) and discovered */
+    deferredToolNames?: string[];
+};
+/** Per-model-call context snapshot, dispatched after pruning and before the LLM call. */
+export type TContextUsageEvent = {
+    runId?: string;
+    agentId?: string;
+    breakdown: TTokenBudgetBreakdown;
+    /** Usable budget this call: maxContextTokens minus output reserve */
+    contextBudget?: number;
+    /** Calibrated instruction overhead actually applied this call */
+    effectiveInstructionTokens?: number;
+    /** Calibrated message tokens before pruning (excluding instructions) */
+    prePruneContextTokens?: number;
+    /** Tokens still free after instructions + pruned messages */
+    remainingContextTokens?: number;
+    calibrationRatio?: number;
+    /** Output tokens of the response's final model call (the call this pre-invoke
+     *  snapshot precedes). Populated only on the persisted `metadata.contextUsage`
+     *  blob so a reloaded multi-call turn adds the same post-snapshot delta the
+     *  live finalizer did — not the full response `tokenCount`, which the snapshot
+     *  already includes for earlier steps. */
+    completedOutputTokens?: number;
+};
+/**
+ * Per-response usage rollup persisted on `responseMessage.metadata.usage`, in
+ * display units (input excludes cache; output includes repaired completion).
+ * Normalized per-event on the backend before summing so a reloaded conversation
+ * reproduces the live branch/total usage exactly, even for mixed-provider turns
+ * (summarization/subagent calls on a different provider than the primary).
+ */
+export type TResponseUsage = {
+    input: number;
+    output: number;
+    cacheWrite: number;
+    cacheRead: number;
+    /** Authoritative USD cost; present only when `interface.contextCost` was on at save */
+    cost?: number;
+};
+/** Provider-reported usage for a single completed model call. */
+export type TTokenUsageEvent = {
+    input_tokens?: number;
+    output_tokens?: number;
+    total_tokens?: number;
+    input_token_details?: {
+        cache_creation?: number;
+        cache_read?: number;
+    };
+    model?: string;
+    provider?: string;
+    /** Non-primary buckets fold into session cost/totals but not the live
+     *  context gauge: hidden sequential-agent calls (`sequential`), summary
+     *  passes (`summarization`), and isolated subagent runs (`subagent`) */
+    usage_type?: 'summarization' | 'subagent' | 'sequential';
+    runId?: string;
+    /** Per-run emission sequence; keeps identical payloads from distinct model calls unique */
+    seq?: number;
+    /** Authoritative USD cost of this call from the backend (premium tiers, cache
+     *  rates); present only when `interface.contextCost` is enabled. Clients sum
+     *  this rather than re-deriving cost from base rates. */
+    cost?: number;
+};
 /** Lifecycle phase carried on subagent-progress envelopes (mirrors SDK SubagentUpdatePhase). */
 export type SubagentUpdatePhase = 'start' | 'run_step' | 'run_step_delta' | 'run_step_completed' | 'message_delta' | 'reasoning_delta' | 'stop' | 'error';
 /** Single streamed subagent update forwarded by the SDK's SubagentExecutor. */

package/dist/types/types/skills.d.ts

@@ -22,9 +22,11 @@ export declare const SKILL_NAME_PATTERN: RegExp;
 /**
  * Source of a skill — where its canonical definition came from.
  * `inline` means the skill was authored directly in LibreChat.
- * `github` / `notion` are reserved for future sync integrations.
+ * `deployment` means the skill was loaded from the server's configured
+ * deployment skill directory and is not persisted as a Skill document.
+ * `github` is populated by admin-configured GitHub skill sync; `notion` is reserved.
  */
-export type SkillSource = 'inline' | 'github' | 'notion';
+export type SkillSource = 'inline' | 'deployment' | 'github' | 'notion';
 /**
  * Category inferred from a skill file's top-level directory prefix.
  * `script` for `scripts/...`, `reference` for `references/...`, `asset` for `assets/...`,
@@ -51,11 +53,23 @@ export type SkillFrontmatter = {
  * Provenance metadata for skills that originated from an external source
  * (e.g. a GitHub commit SHA or a Notion page id).
  *
- * Reserved for phase 2+ external sync — no code path currently populates this
- * in phase 1, but the column exists so a future sync worker can use it
- * without a schema migration.
+ * Populated by external sync workers with upstream identifiers such as source
+ * ids, paths, and commit/blob SHAs.
  */
-export type SkillSourceMetadata = Record<string, string | number | boolean>;
+export type SkillSourceMetadata = Record<string, string | number | boolean> | {
+    provider: 'github';
+    sourceId: string;
+    upstreamId: string;
+    owner: string;
+    repo: string;
+    ref: string;
+    skillPath: string;
+    commitSha?: string;
+    skillBlobSha?: string;
+    syncedAt?: string;
+    syncStatus?: 'synced' | 'failed';
+    error?: string;
+};
 /**
  * A non-blocking coaching hint surfaced alongside a successful create/update
  * response. Unlike validation errors (which return 400 and block the write),
@@ -83,8 +97,8 @@ export type TSkillWarning = {
  * - `frontmatter` is the structured YAML bag minus `name`/`description`
  *   (those live as top-level columns). Validated strictly against a known
  *   key set server-side.
- * - `source`/`sourceMetadata` are reserved for phase 2+ external sync and
- *   always `'inline'` / absent in phase 1.
+ * - `source`/`sourceMetadata` identify whether the row is user-authored,
+ *   deployment-provided, or mirrored from an external source such as GitHub.
  */
 export type TSkill = {
     _id: string;
@@ -170,6 +184,7 @@ export type TSkillFile = {
     isExecutable: boolean;
     author: string;
     tenantId?: string;
+    sourceMetadata?: Record<string, string | number | boolean>;
     /** Lazily cached text content (≤ 512 KB). Excluded from list responses. */
     content?: string;
     /** Set on first read. `true` prevents repeated storage reads for non-text files. */
@@ -177,6 +192,54 @@ export type TSkillFile = {
     createdAt: string;
     updatedAt: string;
 };
+export type TGitHubSkillSyncCredentialSummary = {
+    provider: 'github';
+    credentialKey: string;
+    credentialPresent: boolean;
+    tokenFingerprint?: string;
+    updatedAt?: string;
+    createdAt?: string;
+};
+export type TGitHubSkillSyncSourceStatus = {
+    provider: 'github';
+    sourceId: string;
+    tenantId?: string;
+    status: 'idle' | 'running' | 'succeeded' | 'failed' | 'skipped';
+    credentialKey?: string;
+    credentialPresent: boolean;
+    owner?: string;
+    repo?: string;
+    ref?: string;
+    paths?: string[];
+    startedAt?: string;
+    finishedAt?: string;
+    lastSuccessAt?: string;
+    lastFailureAt?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    syncedSkillCount: number;
+    syncedFileCount: number;
+    deletedSkillCount: number;
+    deletedFileCount: number;
+    updatedAt?: string;
+    createdAt?: string;
+};
+export type TGitHubSkillSyncStatusResponse = {
+    enabled: boolean;
+    intervalMinutes: number;
+    runOnStartup: boolean;
+    sources: TGitHubSkillSyncSourceStatus[];
+    credentials: TGitHubSkillSyncCredentialSummary[];
+    fineGrainedTokenRecommendation: string;
+};
+export type TGitHubSkillSyncCredentialUpdateRequest = {
+    token: string;
+};
+export type TGitHubSkillSyncManualRunResponse = {
+    status: 'started' | 'skipped' | 'completed' | 'failed';
+    message?: string;
+    sources?: TGitHubSkillSyncSourceStatus[];
+};
 /** Request body for POST `/api/skills`. */
 export type TCreateSkill = {
     name: string;
@@ -185,7 +248,7 @@ export type TCreateSkill = {
     body: string;
     frontmatter?: Partial<SkillFrontmatter>;
     category?: string;
-    /** When `true`, the skill auto-primes into every turn (mirrors `always-apply` frontmatter). */
+    /** When `true`, the skill auto-primes into every turn (mirrors always-apply frontmatter). */
     alwaysApply?: boolean;
 };
 /** Partial payload for PATCH `/api/skills/:id` — all fields optional. */

package/dist/types/types.d.ts

@@ -1,5 +1,5 @@
 import type { InfiniteData } from '@tanstack/react-query';
-import type { TConversationTag, EModelEndpoint, TConversation, TSharedLink, TAttachment, TMessage, TBanner } from './schemas';
+import type { TConversationTag, EModelEndpoint, TConversation, TSharedLink, TAttachment, TMessage, TBanner, ReasoningResponseKey, ReasoningParameterFormat } from './schemas';
 import type { RefillIntervalUnit } from './balance';
 import type { SettingDefinition } from './generate';
 import type { TMinimalFeedback } from './feedback';
@@ -7,7 +7,7 @@ import type { ContentTypes } from './types/runs';
 import type { Agent } from './types/assistants';
 export * from './schemas';
 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' | 'thinking' | 'thinkingBudget' | 'thinkingLevel' | 'effort' | 'thinkingDisplay' | 'assistant_id' | 'agent_id' | 'iconURL' | 'greeting' | 'spec' | 'artifacts' | 'file_ids' | 'system' | 'examples' | 'context'> & {
+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' | 'thinking' | 'thinkingBudget' | 'thinkingLevel' | 'effort' | 'thinkingDisplay' | 'assistant_id' | 'agent_id' | 'iconURL' | 'greeting' | 'spec' | 'artifacts' | 'file_ids' | 'system' | 'chatProjectId' | 'examples' | 'context'> & {
     modelDisplayLabel?: string;
     key?: string | null;
     /** @deprecated Assistants API */
@@ -63,6 +63,8 @@ export type TSubmission = {
     isContinued?: boolean;
     isTemporary: boolean;
     messages: TMessage[];
+    /** Client-only full message context used to restore branch siblings after scoped regenerate. */
+    regenerateMessages?: TMessage[];
     isRegenerate?: boolean;
     initialResponse?: TMessage;
     conversation: Partial<TConversation>;
@@ -185,6 +187,37 @@ export type TUpdateConversationRequest = {
     title: string;
 };
 export type TUpdateConversationResponse = TConversation;
+export type TChatProject = {
+    _id: string;
+    name: string;
+    description?: string;
+    user?: string;
+    conversationCount: number;
+    lastConversationAt?: string | null;
+    lastConversationId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type TCreateChatProjectRequest = {
+    name: string;
+    description?: string;
+};
+export type TUpdateChatProjectRequest = Partial<TCreateChatProjectRequest> & {
+    projectId: string;
+};
+export type TDeleteChatProjectResponse = {
+    deletedCount: number;
+    modifiedCount: number;
+};
+export type TAssignConversationToProjectRequest = {
+    conversationId: string;
+    projectId: string | null;
+};
+export type TAssignConversationToProjectResponse = {
+    conversation: TConversation;
+    previousProjectId: string | null;
+    projectId: string | null;
+};
 export type TDeleteConversationRequest = {
     conversationId?: string;
     thread_id?: string;
@@ -209,7 +242,9 @@ export type TSharedMessagesResponse = Omit<TSharedLink, 'messages'> & {
 };
 export type TCreateShareLinkRequest = Pick<TConversation, 'conversationId'>;
 export type TUpdateShareLinkRequest = Pick<TSharedLink, 'shareId' | 'targetMessageId'>;
-export type TSharedLinkResponse = Pick<TSharedLink, 'shareId'> & Pick<TSharedLink, 'targetMessageId'> & Pick<TConversation, 'conversationId'>;
+export type TSharedLinkResponse = Pick<TSharedLink, 'shareId'> & Pick<TSharedLink, 'targetMessageId'> & Pick<TConversation, 'conversationId'> & {
+    _id?: string;
+};
 export type TSharedLinkGetResponse = Omit<TSharedLinkResponse, 'shareId'> & {
     shareId: string | null;
     success: boolean;
@@ -274,11 +309,23 @@ export type TConfig = {
     capabilities?: string[];
     customParams?: {
         defaultParamsEndpoint?: string;
+        reasoningFormat?: ReasoningParameterFormat;
+        reasoningKey?: ReasoningResponseKey;
         paramDefinitions?: Partial<SettingDefinition>[];
     };
 };
 export type TEndpointsConfig = Record<EModelEndpoint | string, TConfig | null | undefined> | undefined;
 export type TModelsConfig = Record<string, string[]>;
+/** Server-resolved context window and pricing for one model. Rates are USD per 1M tokens. */
+export type TModelTokenomics = {
+    context?: number;
+    prompt?: number;
+    completion?: number;
+    cacheWrite?: number;
+    cacheRead?: number;
+};
+/** endpoint → model → resolved tokenomics, from GET /api/endpoints/token-config */
+export type TTokenConfigMap = Record<string, Record<string, TModelTokenomics>>;
 export type TUpdateTokenCountResponse = {
     count: number;
 };

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "librechat-data-provider",
-  "version": "0.8.503",
+  "version": "0.8.505",
   "description": "data services for librechat apps",
   "main": "dist/index.js",
-  "module": "dist/index.es.js",
+  "module": "dist/index.mjs",
   "types": "./dist/types/index.d.ts",
   "sideEffects": false,
   "exports": {
     ".": {
-      "import": "./dist/index.es.js",
+      "import": "./dist/index.mjs",
       "require": "./dist/index.js",
       "types": "./dist/types/index.d.ts"
     },
     "./react-query": {
-      "import": "./dist/react-query/index.es.js",
+      "import": "./dist/react-query/index.mjs",
       "require": "./dist/react-query/index.js",
       "types": "./dist/types/react-query/index.d.ts"
     }
@@ -23,14 +23,14 @@
   ],
   "scripts": {
     "clean": "rimraf dist",
-    "build": "npm run clean && rollup -c --silent --bundleConfigAsCjs",
-    "build:watch": "rollup -c -w",
+    "build": "npm run clean && tsdown && tsc -p tsconfig.build.json",
+    "build:watch": "tsdown --watch",
     "rollup:api": "npx rollup -c server-rollup.config.js --bundleConfigAsCjs",
     "test": "jest --coverage --watch",
     "test:ci": "jest --coverage --ci --logHeapUsage",
     "verify": "npm run test:ci",
     "b:clean": "bun run rimraf dist",
-    "b:build": "bun run b:clean && bun run rollup -c --silent --bundleConfigAsCjs"
+    "b:build": "bun run b:clean && bun run tsdown && bun run tsc -p tsconfig.build.json"
   },
   "repository": {
     "type": "git",
@@ -57,20 +57,18 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.1.0",
     "@rollup/plugin-replace": "^5.0.5",
-    "@rollup/plugin-terser": "^1.0.0",
     "@types/jest": "^29.5.2",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.3.0",
+    "@types/node": "^24.12.4",
     "@types/react": "^18.2.18",
     "@types/winston": "^2.4.4",
     "jest": "^30.2.0",
-    "jest-junit": "^16.0.0",
+    "jest-junit": "^17.0.0",
     "openapi-types": "^12.1.3",
     "rimraf": "^6.1.3",
     "rollup": "^4.34.9",
-    "rollup-plugin-peer-deps-external": "^2.2.4",
-    "rollup-plugin-typescript2": "^0.37.0",
-    "typescript": "^5.0.4"
+    "tsdown": "^0.22.2",
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^4.28.0"