librechat-data-provider 0.8.402 → 0.8.404

package/dist/types/types/graph.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Microsoft Graph API type definitions
+ * Based on Microsoft Graph REST API v1.0 documentation
+ */
+/**
+ * Person type information from Microsoft Graph People API
+ */
+export interface TGraphPersonType {
+    /** Classification of the entity: "Person" or "Group" */
+    class: 'Person' | 'Group';
+    /** Specific subtype: e.g., "OrganizationUser", "UnifiedGroup" */
+    subclass: string;
+}
+/**
+ * Scored email address from Microsoft Graph People API
+ */
+export interface TGraphScoredEmailAddress {
+    /** Email address */
+    address: string;
+    /** Relevance score (0.0 to 1.0) */
+    relevanceScore: number;
+}
+/**
+ * Phone number from Microsoft Graph API
+ */
+export interface TGraphPhone {
+    /** Type of phone number */
+    type: string;
+    /** Phone number */
+    number: string;
+}
+/**
+ * Person/Contact result from Microsoft Graph /me/people endpoint
+ */
+export interface TGraphPerson {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    displayName: string;
+    /** Given name (first name) */
+    givenName?: string;
+    /** Surname (last name) */
+    surname?: string;
+    /** User principal name */
+    userPrincipalName?: string;
+    /** Job title */
+    jobTitle?: string;
+    /** Department */
+    department?: string;
+    /** Company name */
+    companyName?: string;
+    /** Primary email address */
+    mail?: string;
+    /** Scored email addresses with relevance */
+    scoredEmailAddresses?: TGraphScoredEmailAddress[];
+    /** Person type classification */
+    personType?: TGraphPersonType;
+    /** Phone numbers */
+    phones?: TGraphPhone[];
+}
+/**
+ * User result from Microsoft Graph /users endpoint
+ */
+export interface TGraphUser {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    displayName: string;
+    /** Given name (first name) */
+    givenName?: string;
+    /** Surname (last name) */
+    surname?: string;
+    /** User principal name */
+    userPrincipalName: string;
+    /** Primary email address */
+    mail?: string;
+    /** Job title */
+    jobTitle?: string;
+    /** Department */
+    department?: string;
+    /** Office location */
+    officeLocation?: string;
+    /** Business phone numbers */
+    businessPhones?: string[];
+    /** Mobile phone number */
+    mobilePhone?: string;
+}
+/**
+ * Group result from Microsoft Graph /groups endpoint
+ */
+export interface TGraphGroup {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    displayName: string;
+    /** Group email address */
+    mail?: string;
+    /** Mail nickname */
+    mailNickname?: string;
+    /** Group description */
+    description?: string;
+    /** Group types (e.g., ["Unified"] for Microsoft 365 groups) */
+    groupTypes?: string[];
+    /** Whether group is mail-enabled */
+    mailEnabled?: boolean;
+    /** Whether group is security-enabled */
+    securityEnabled?: boolean;
+    /** Resource provisioning options */
+    resourceProvisioningOptions?: string[];
+}
+/**
+ * Response wrapper for Microsoft Graph API list endpoints
+ */
+export interface TGraphListResponse<T> {
+    /** Array of results */
+    value: T[];
+    /** OData context */
+    '@odata.context'?: string;
+    /** Next page link */
+    '@odata.nextLink'?: string;
+    /** Count of results (if requested) */
+    '@odata.count'?: number;
+}
+/**
+ * Response from /me/people endpoint
+ */
+export type TGraphPeopleResponse = TGraphListResponse<TGraphPerson>;
+/**
+ * Response from /users endpoint
+ */
+export type TGraphUsersResponse = TGraphListResponse<TGraphUser>;
+/**
+ * Response from /groups endpoint
+ */
+export type TGraphGroupsResponse = TGraphListResponse<TGraphGroup>;

package/{src/types/mcpServers.ts → dist/types/types/mcpServers.d.ts}

@@ -1,49 +1,43 @@
 import type { MCPOptions, MCPServerUserInput } from '../mcp';
-
 /**
  * Base MCP Server interface
  * Core structure shared between API and database layers
  */
 export interface IMCPServerDB {
-  _id?: string; // MongoDB ObjectId (used for ACL/permissions)
-  serverName: string;
-  config: MCPOptions;
-  author?: string | null;
-  createdAt?: Date;
-  updatedAt?: Date;
+    _id?: string;
+    serverName: string;
+    config: MCPOptions;
+    author?: string | null;
+    createdAt?: Date;
+    updatedAt?: Date;
 }
-
 /**
  * User-managed MCP Server (standalone, not attached to agent)
  * API type for frontend/backend communication
  * Similar to Agent type - includes populated author fields
  */
 export type MCPServerDB = IMCPServerDB;
-
 /**
  * Parameters for creating a new user-managed MCP server
  * Note: Only UI-editable fields are allowed (excludes server-managed fields)
  */
 export type MCPServerCreateParams = {
-  config: MCPServerUserInput; // UI fields only (title, description, url, oauth, iconPath)
+    config: MCPServerUserInput;
 };
-
 /**
  * Parameters for updating an existing user-managed MCP server
  * Note: Only UI-editable fields are allowed (excludes server-managed fields)
  */
 export type MCPServerUpdateParams = {
-  config?: MCPServerUserInput; // UI fields only (title, description, url, oauth, iconPath)
+    config?: MCPServerUserInput;
 };
-
 /**
  * Response for MCP server list endpoint
  */
 export type MCPServerDBObjectResponse = {
-  dbId?: string;
-  serverName: string;
-  /** True if access is only via agent (not directly shared with user) */
-  consumeOnly?: boolean;
+    dbId?: string;
+    serverName: string;
+    /** True if access is only via agent (not directly shared with user) */
+    consumeOnly?: boolean;
 } & MCPOptions;
-
 export type MCPServersListResponse = Record<string, MCPServerDBObjectResponse>;

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

@@ -0,0 +1,209 @@
+import * as types from '../types';
+import * as r from '../roles';
+import * as p from '../permissions';
+import { Tools, Assistant, AssistantCreateParams, AssistantUpdateParams, FunctionTool, AssistantDocument, Agent, AgentCreateParams, AgentUpdateParams } from './assistants';
+import { Action, ActionMetadata } from './agents';
+export type MutationOptions<Response, Request, Context = unknown, Error = unknown, Snapshot = void> = {
+    onSuccess?: (data: Response, variables: Request, context?: Context) => void;
+    onMutate?: (variables: Request) => Snapshot | Promise<Snapshot>;
+    onError?: (error: Error, variables: Request, context?: Context, snapshot?: Snapshot) => void;
+    onSettled?: (data: Response | undefined, error: Error | null, variables: Request, context?: Context) => void;
+};
+export type TGenTitleRequest = {
+    conversationId: string;
+};
+export type TGenTitleResponse = {
+    title: string;
+};
+export type PresetDeleteResponse = {
+    acknowledged: boolean;
+    deletedCount: number;
+};
+export type UpdatePresetOptions = MutationOptions<types.TPreset, types.TPreset>;
+export type DeletePresetOptions = MutationOptions<PresetDeleteResponse, types.TPreset | undefined>;
+export type AssistantAvatarVariables = {
+    assistant_id: string;
+    model: string;
+    formData: FormData;
+    postCreation?: boolean;
+    endpoint: types.AssistantsEndpoint;
+    version: number | string;
+};
+export type UpdateActionVariables = {
+    assistant_id: string;
+    functions: FunctionTool[];
+    metadata: ActionMetadata;
+    action_id?: string;
+    model: string;
+    endpoint: types.AssistantsEndpoint;
+    version: number | string;
+};
+export type UploadAssistantAvatarOptions = MutationOptions<Assistant, AssistantAvatarVariables>;
+export type CreateAssistantMutationOptions = MutationOptions<Assistant, AssistantCreateParams>;
+export type UpdateAssistantVariables = {
+    assistant_id: string;
+    data: AssistantUpdateParams;
+};
+export type UpdateAssistantMutationOptions = MutationOptions<Assistant, UpdateAssistantVariables>;
+export type DeleteAssistantBody = {
+    assistant_id: string;
+    model: string;
+    endpoint: types.AssistantsEndpoint;
+};
+export type DeleteAssistantMutationOptions = MutationOptions<void, Pick<DeleteAssistantBody, 'assistant_id'>>;
+export type UpdateActionResponse = [AssistantDocument, Assistant, Action];
+export type UpdateActionOptions = MutationOptions<UpdateActionResponse, UpdateActionVariables>;
+export type DeleteActionVariables = {
+    endpoint: types.AssistantsEndpoint;
+    assistant_id: string;
+    action_id: string;
+    model: string;
+};
+export type DeleteActionOptions = MutationOptions<void, DeleteActionVariables>;
+export type AgentAvatarVariables = {
+    agent_id: string;
+    formData: FormData;
+};
+export type UpdateAgentActionVariables = {
+    agent_id: string;
+    action_id?: string;
+    metadata: ActionMetadata;
+    functions: FunctionTool[];
+};
+export type UploadAgentAvatarOptions = MutationOptions<Agent, AgentAvatarVariables>;
+export type CreateAgentMutationOptions = MutationOptions<Agent, AgentCreateParams>;
+export type UpdateAgentVariables = {
+    agent_id: string;
+    data: AgentUpdateParams;
+};
+export type DuplicateVersionError = Error & {
+    statusCode?: number;
+    details?: {
+        duplicateVersion?: unknown;
+        versionIndex?: number;
+    };
+};
+export type UpdateAgentMutationOptions = MutationOptions<Agent, UpdateAgentVariables>;
+export type DuplicateAgentBody = {
+    agent_id: string;
+};
+export type DuplicateAgentMutationOptions = MutationOptions<{
+    agent: Agent;
+    actions: Action[];
+}, Pick<DuplicateAgentBody, 'agent_id'>>;
+export type DeleteAgentBody = {
+    agent_id: string;
+};
+export type DeleteAgentMutationOptions = MutationOptions<void, Pick<DeleteAgentBody, 'agent_id'>>;
+export type UpdateAgentActionResponse = [Agent, Action];
+export type UpdateAgentActionOptions = MutationOptions<UpdateAgentActionResponse, UpdateAgentActionVariables>;
+export type DeleteAgentActionVariables = {
+    agent_id: string;
+    action_id: string;
+};
+export type DeleteAgentActionOptions = MutationOptions<void, DeleteAgentActionVariables>;
+export type RevertAgentVersionVariables = {
+    agent_id: string;
+    version_index: number;
+};
+export type RevertAgentVersionOptions = MutationOptions<Agent, RevertAgentVersionVariables>;
+export type DeleteConversationOptions = MutationOptions<types.TDeleteConversationResponse, types.TDeleteConversationRequest>;
+export type ArchiveConversationOptions = MutationOptions<types.TArchiveConversationResponse, types.TArchiveConversationRequest>;
+export type DuplicateConvoOptions = MutationOptions<types.TDuplicateConvoResponse, types.TDuplicateConvoRequest>;
+export type ForkConvoOptions = MutationOptions<types.TForkConvoResponse, types.TForkConvoRequest>;
+export type CreateSharedLinkOptions = MutationOptions<types.TSharedLink, Partial<types.TSharedLink>>;
+export type updateTagsInConvoOptions = MutationOptions<types.TTagConversationResponse, types.TTagConversationRequest>;
+export type UpdateSharedLinkOptions = MutationOptions<types.TSharedLink, Partial<types.TSharedLink>>;
+export type ArchiveConvoOptions = MutationOptions<types.TArchiveConversationResponse, types.TArchiveConversationRequest>;
+export type DeleteSharedLinkContext = {
+    previousQueries?: Map<string, TDeleteSharedLinkResponse>;
+};
+export type DeleteSharedLinkOptions = MutationOptions<TDeleteSharedLinkResponse, {
+    shareId: string;
+}, DeleteSharedLinkContext>;
+export type TUpdatePromptContext = {
+    group?: types.TPromptGroup;
+    previousListData?: types.PromptGroupListData;
+} | undefined;
+export type UpdatePromptGroupOptions = MutationOptions<types.TUpdatePromptGroupResponse, types.TUpdatePromptGroupVariables, TUpdatePromptContext>;
+export type CreatePromptOptions = MutationOptions<types.TCreatePromptResponse, types.TCreatePrompt>;
+export type DeletePromptOptions = MutationOptions<types.TDeletePromptResponse, types.TDeletePromptVariables>;
+export type DeletePromptGroupOptions = MutationOptions<types.TDeletePromptGroupResponse, types.TDeletePromptGroupRequest>;
+export type UpdatePromptLabelOptions = MutationOptions<types.TUpdatePromptLabelsResponse, types.TUpdatePromptLabelsRequest>;
+export type MakePromptProductionOptions = MutationOptions<types.TMakePromptProductionResponse, types.TMakePromptProductionRequest, TUpdatePromptContext>;
+export type VerifyEmailOptions = MutationOptions<types.VerifyEmailResponse, types.TVerifyEmail>;
+export type ResendVerifcationOptions = MutationOptions<types.VerifyEmailResponse, types.TResendVerificationEmail>;
+export type RegistrationOptions = MutationOptions<types.TRegisterUserResponse, types.TRegisterUser, unknown, types.TError>;
+export type UpdatePermVars<T> = {
+    roleName: string;
+    updates: Partial<T>;
+};
+export type UpdatePromptPermVars = UpdatePermVars<p.TPromptPermissions>;
+export type UpdateMemoryPermVars = UpdatePermVars<p.TMemoryPermissions>;
+export type UpdateAgentPermVars = UpdatePermVars<p.TAgentPermissions>;
+export type UpdatePeoplePickerPermVars = UpdatePermVars<p.TPeoplePickerPermissions>;
+export type UpdateMCPServersPermVars = UpdatePermVars<p.TMcpServersPermissions>;
+export type UpdatePermResponse = r.TRole;
+export type UpdatePromptPermOptions = MutationOptions<UpdatePermResponse, UpdatePromptPermVars, unknown, types.TError | null | undefined>;
+export type UpdateMemoryPermOptions = MutationOptions<UpdatePermResponse, UpdateMemoryPermVars, unknown, types.TError | null | undefined>;
+export type UpdateAgentPermOptions = MutationOptions<UpdatePermResponse, UpdateAgentPermVars, unknown, types.TError | null | undefined>;
+export type UpdatePeoplePickerPermOptions = MutationOptions<UpdatePermResponse, UpdatePeoplePickerPermVars, unknown, types.TError | null | undefined>;
+export type UpdateMCPServersPermOptions = MutationOptions<UpdatePermResponse, UpdateMCPServersPermVars, unknown, types.TError | null | undefined>;
+export type UpdateRemoteAgentsPermVars = UpdatePermVars<p.TRemoteAgentsPermissions>;
+export type UpdateRemoteAgentsPermOptions = MutationOptions<UpdatePermResponse, UpdateRemoteAgentsPermVars, unknown, types.TError | null | undefined>;
+export type UpdateMarketplacePermVars = UpdatePermVars<p.TMarketplacePermissions>;
+export type UpdateMarketplacePermOptions = MutationOptions<UpdatePermResponse, UpdateMarketplacePermVars, unknown, types.TError | null | undefined>;
+export type UpdateConversationTagOptions = MutationOptions<types.TConversationTag, types.TConversationTagRequest>;
+export type DeleteConversationTagOptions = MutationOptions<types.TConversationTag, string>;
+export type AcceptTermsMutationOptions = MutationOptions<types.TAcceptTermsResponse, void, unknown, void>;
+export type UpdatePluginAuthOptions = MutationOptions<types.TUser, types.TUpdateUserPlugins>;
+export type ToolParamsMap = {
+    [Tools.execute_code]: {
+        lang: string;
+        code: string;
+    };
+};
+export type ToolId = keyof ToolParamsMap;
+export type ToolParams<T extends ToolId> = ToolParamsMap[T] & {
+    messageId: string;
+    partIndex?: number;
+    blockIndex?: number;
+    conversationId: string;
+};
+export type ToolCallResponse = {
+    result: unknown;
+    attachments?: types.TAttachment[];
+};
+export type ToolCallMutationOptions<T extends ToolId> = MutationOptions<ToolCallResponse, ToolParams<T>>;
+export type TDeleteSharedLinkResponse = {
+    success: boolean;
+    shareId: string;
+    message: string;
+};
+export type TEditArtifactRequest = {
+    index: number;
+    messageId: string;
+    original: string;
+    updated: string;
+};
+export type TEditArtifactResponse = Pick<types.TMessage, 'content' | 'text' | 'conversationId'>;
+export type EditArtifactOptions = MutationOptions<TEditArtifactResponse, TEditArtifactRequest, unknown, Error>;
+export type TBranchMessageRequest = {
+    messageId: string;
+    agentId: string;
+};
+export type TBranchMessageResponse = types.TMessage;
+export type BranchMessageOptions = MutationOptions<TBranchMessageResponse, TBranchMessageRequest, unknown, Error>;
+export type TLogoutResponse = {
+    message: string;
+    redirect?: string;
+};
+export type LogoutOptions = MutationOptions<TLogoutResponse, undefined>;
+export interface AssistantInitialize {
+    message: string;
+    error?: string;
+}
+export interface CancelMCPOAuthResponse {
+    success: boolean;
+    message: string;
+}

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

@@ -0,0 +1,169 @@
+import type { InfiniteData } from '@tanstack/react-query';
+import type * as p from '../accessPermissions';
+import type * as a from '../types/agents';
+import type * as s from '../schemas';
+import type * as t from '../types';
+export type Conversation = {
+    id: string;
+    createdAt: number;
+    participants: string[];
+    lastMessage: string;
+    conversations: s.TConversation[];
+};
+export type ConversationListParams = {
+    cursor?: string;
+    isArchived?: boolean;
+    sortBy?: 'title' | 'createdAt' | 'updatedAt';
+    sortDirection?: 'asc' | 'desc';
+    tags?: string[];
+    search?: string;
+};
+export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'user'>;
+export type ConversationListResponse = {
+    conversations: MinimalConversation[];
+    nextCursor: string | null;
+};
+export type ConversationData = InfiniteData<ConversationListResponse>;
+export type ConversationUpdater = (data: ConversationData, conversation: s.TConversation) => ConversationData;
+export type MessagesListParams = {
+    cursor?: string | null;
+    sortBy?: 'endpoint' | 'createdAt' | 'updatedAt';
+    sortDirection?: 'asc' | 'desc';
+    pageSize?: number;
+    conversationId?: string;
+    messageId?: string;
+    search?: string;
+};
+export type MessagesListResponse = {
+    messages: s.TMessage[];
+    nextCursor: string | null;
+};
+export type SharedMessagesResponse = Omit<s.TSharedLink, 'messages'> & {
+    messages: s.TMessage[];
+};
+export interface SharedLinksListParams {
+    pageSize: number;
+    isPublic: boolean;
+    sortBy: 'title' | 'createdAt';
+    sortDirection: 'asc' | 'desc';
+    search?: string;
+    cursor?: string;
+}
+export type SharedLinkItem = {
+    shareId: string;
+    title: string;
+    isPublic: boolean;
+    createdAt: Date;
+    conversationId: string;
+};
+export interface SharedLinksResponse {
+    links: SharedLinkItem[];
+    nextCursor: string | null;
+    hasNextPage: boolean;
+}
+export interface SharedLinkQueryData {
+    pages: SharedLinksResponse[];
+    pageParams: (string | null)[];
+}
+export type AllPromptGroupsFilterRequest = {
+    category: string;
+    pageNumber: string;
+    pageSize: string | number;
+    before?: string | null;
+    after?: string | null;
+    order?: 'asc' | 'desc';
+    name?: string;
+    author?: string;
+};
+export type AllPromptGroupsResponse = t.TPromptGroup[];
+export type ConversationTagsResponse = s.TConversationTag[];
+export type MCPTool = {
+    name: string;
+    pluginKey: string;
+    description: string;
+};
+export type MCPServer = {
+    name: string;
+    icon: string;
+    authenticated: boolean;
+    authConfig: s.TPluginAuthConfig[];
+    tools: MCPTool[];
+};
+export type MCPServersResponse = {
+    servers: Record<string, MCPServer>;
+};
+export type VerifyToolAuthParams = {
+    toolId: string;
+};
+export type VerifyToolAuthResponse = {
+    authenticated: boolean;
+    message?: string | s.AuthType;
+    authTypes?: [string, s.AuthType][];
+};
+export type GetToolCallParams = {
+    conversationId: string;
+};
+export type ToolCallResults = a.ToolCallResult[];
+export type TUserMemory = {
+    key: string;
+    value: string;
+    updated_at: string;
+    tokenCount?: number;
+};
+export type MemoriesResponse = {
+    memories: TUserMemory[];
+    totalTokens: number;
+    tokenLimit: number | null;
+    usagePercentage: number | null;
+};
+export type PrincipalSearchParams = {
+    q: string;
+    limit?: number;
+    types?: Array<p.PrincipalType.USER | p.PrincipalType.GROUP | p.PrincipalType.ROLE>;
+};
+export type PrincipalSearchResponse = {
+    query: string;
+    limit: number;
+    types?: Array<p.PrincipalType.USER | p.PrincipalType.GROUP | p.PrincipalType.ROLE>;
+    results: p.TPrincipalSearchResult[];
+    count: number;
+    sources: {
+        local: number;
+        entra: number;
+    };
+};
+export type AccessRole = {
+    accessRoleId: p.AccessRoleIds;
+    name: string;
+    description: string;
+    permBits: number;
+};
+export type AccessRolesResponse = AccessRole[];
+export interface MCPServerStatus {
+    requiresOAuth: boolean;
+    connectionState: 'disconnected' | 'connecting' | 'connected' | 'error';
+}
+export interface MCPConnectionStatusResponse {
+    success: boolean;
+    connectionStatus: Record<string, MCPServerStatus>;
+}
+export interface MCPServerConnectionStatusResponse {
+    success: boolean;
+    serverName: string;
+    requiresOAuth: boolean;
+    connectionStatus: 'disconnected' | 'connecting' | 'connected' | 'error';
+}
+export interface MCPAuthValuesResponse {
+    success: boolean;
+    serverName: string;
+    authValueFlags: Record<string, boolean>;
+}
+export type GraphTokenParams = {
+    scopes: string;
+};
+export type GraphTokenResponse = {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    scope: string;
+};

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

@@ -0,0 +1,36 @@
+export declare enum ContentTypes {
+    TEXT = "text",
+    THINK = "think",
+    TEXT_DELTA = "text_delta",
+    TOOL_CALL = "tool_call",
+    IMAGE_FILE = "image_file",
+    IMAGE_URL = "image_url",
+    VIDEO_URL = "video_url",
+    INPUT_AUDIO = "input_audio",
+    AGENT_UPDATE = "agent_update",
+    SUMMARY = "summary",
+    ERROR = "error"
+}
+export declare enum StepTypes {
+    TOOL_CALLS = "tool_calls",
+    MESSAGE_CREATION = "message_creation"
+}
+export declare enum ToolCallTypes {
+    FUNCTION = "function",
+    RETRIEVAL = "retrieval",
+    FILE_SEARCH = "file_search",
+    CODE_INTERPRETER = "code_interpreter",
+    TOOL_CALL = "tool_call"
+}
+/** Event names dispatched by the agent graph and consumed by step handlers. */
+export declare enum StepEvents {
+    ON_RUN_STEP = "on_run_step",
+    ON_AGENT_UPDATE = "on_agent_update",
+    ON_MESSAGE_DELTA = "on_message_delta",
+    ON_REASONING_DELTA = "on_reasoning_delta",
+    ON_RUN_STEP_DELTA = "on_run_step_delta",
+    ON_RUN_STEP_COMPLETED = "on_run_step_completed",
+    ON_SUMMARIZE_START = "on_summarize_start",
+    ON_SUMMARIZE_DELTA = "on_summarize_delta",
+    ON_SUMMARIZE_COMPLETE = "on_summarize_complete"
+}