Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
import type { AppConfig, IConversation, IUser } from '@librechat/data-schemas';
import type { TFile } from 'librechat-data-provider';
import type { ResolvedChatProjectContext } from '../projects/context';
import type { RequestBody, ServerRequest } from '~/types';
/**
* Runtime-only state required to initialize and execute an Agent run.
*
* This context deliberately contains no transport objects. Ingress adapters
* may derive it from HTTP, while future execution hosts can rehydrate it from
* an authenticated principal and deployment configuration.
*/
export interface AgentExecutionContext {
user?: IUser;
appConfig?: AppConfig;
requestBody: RequestBody;
/** Server-captured logical turn start time used by prompt variables. */
turnStartedAt: number;
/** Server-captured conversation creation time retained as historical metadata. */
conversationCreatedAt?: string;
/** Conversation already resolved by ingress. Presence distinguishes "not read" from absent. */
resolvedConversation?: Partial<IConversation> | null;
/** Authoritative per-turn project context; server-only and never request body data. */
chatProjectContext?: ResolvedChatProjectContext | null;
/** Metadata-only project files hydrated once per request for enabled file search tools. */
chatProjectFiles?: TFile[];
/** Shares in-flight project-context resource hydration across graph agents. */
chatProjectContextResourcesPromise?: Promise<ResolvedChatProjectContext>;
/** Shares in-flight hydration across concurrently initialized graph agents. */
chatProjectFilesPromise?: Promise<TFile[]>;
/** Subagents that run on their parent's machine this turn, keyed by saved agent ID. */
codeWorkspaceInheritance?: ReadonlyMap<string, string>;
}
/** Creates the transport-free context at the existing HTTP adapter seam. */
export function createAgentExecutionContext({
user,
appConfig,
requestBody,
turnStartedAt = Date.now(),
conversationCreatedAt,
resolvedConversation,
hasResolvedConversation = false,
chatProjectContext,
chatProjectFiles,
chatProjectContextResourcesPromise,
chatProjectFilesPromise,
codeWorkspaceInheritance,
}: {
user?: IUser;
appConfig?: AppConfig;
requestBody: RequestBody;
turnStartedAt?: number;
conversationCreatedAt?: string;
resolvedConversation?: Partial<IConversation> | null;
hasResolvedConversation?: boolean;
chatProjectContext?: ResolvedChatProjectContext | null;
chatProjectFiles?: TFile[];
chatProjectContextResourcesPromise?: Promise<ResolvedChatProjectContext>;
chatProjectFilesPromise?: Promise<TFile[]>;
codeWorkspaceInheritance?: ReadonlyMap<string, string>;
}): AgentExecutionContext {
const context: AgentExecutionContext = {
user,
appConfig,
requestBody,
turnStartedAt,
conversationCreatedAt,
...(chatProjectContext !== undefined ? { chatProjectContext } : {}),
...(chatProjectContextResourcesPromise !== undefined
? { chatProjectContextResourcesPromise }
: {}),
...(chatProjectFiles !== undefined ? { chatProjectFiles } : {}),
...(chatProjectFilesPromise !== undefined ? { chatProjectFilesPromise } : {}),
...(codeWorkspaceInheritance !== undefined ? { codeWorkspaceInheritance } : {}),
};
if (hasResolvedConversation) {
context.resolvedConversation = resolvedConversation ?? null;
}
return context;
}
/** Temporary adapter for request-backed Agent entry points. */
export function createRequestAgentExecutionContext(
req: ServerRequest,
requestBody: RequestBody = req.body ?? {},
): AgentExecutionContext {
const turnStartedAt = req.turnStartedAt ?? Date.now();
req.turnStartedAt = turnStartedAt;
return createAgentExecutionContext({
user: req.user,
appConfig: req.config,
requestBody,
turnStartedAt,
conversationCreatedAt: req.conversationCreatedAt,
resolvedConversation: req.resolvedConversation,
hasResolvedConversation: Object.prototype.hasOwnProperty.call(req, 'resolvedConversation'),
chatProjectContext: req.chatProjectContext,
chatProjectFiles: req.chatProjectFiles,
chatProjectContextResourcesPromise: req.chatProjectContextResourcesPromise,
chatProjectFilesPromise: req.chatProjectFilesPromise,
codeWorkspaceInheritance: req.codeWorkspaceInheritance,
});
}