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 { createContext, useContext, useMemo } from 'react';
import { useSetAtom } from 'jotai';
import { activeSubagentPanel, subagentPanelFocusRequest } from '@librechat/chat/react';
import type { ActiveSubagentPanel } from '@librechat/chat/react';
import type { ReactNode } from 'react';
import type { ComposerBindings } from '~/hooks/Input/useComposerBindings';
/**
* Everything this feature needs from the application hosting it, and nothing
* it owns itself. Reading these through the host instead of the app store is
* what keeps the feature liftable: a second host already exists (the shared
* conversation view), and a host outside this repository would satisfy the
* same six members without the feature learning where they come from.
*/
export interface ChatSurface {
/** Enter submits a composer; without it, Enter inserts a newline. */
enterToSend: boolean;
/** Message rows stretch to the container instead of the reading column. */
maximizeChatSpace: boolean;
/** The reader wants a jump-to-bottom control on scrollable transcripts. */
showScrollButton: boolean;
/** The reader's effective composer shortcut bindings. */
composerBindings: ComposerBindings;
/** Take the shell's foreground slot — the host closes whatever else holds it. */
claimForeground: () => void;
/** Carry unsent composer words into a conversation the host is about to open. */
handOffComposerText: (conversationId: string, text: string) => void;
}
const ChatSurfaceContext = createContext<ChatSurface | null>(null);
export function ChatSurfaceProvider({
value,
children,
}: {
value: ChatSurface;
children: ReactNode;
}) {
return <ChatSurfaceContext.Provider value={value}>{children}</ChatSurfaceContext.Provider>;
}
export function useChatSurface(): ChatSurface {
const surface = useContext(ChatSurfaceContext);
if (surface == null) {
throw new Error('useChatSurface must be used within a ChatSurfaceProvider');
}
return surface;
}
/** The host, where one exists. A subagent card is rendered by every message
* renderer, and search results are not a chat surface. */
export function useOptionalChatSurface(): ChatSurface | null {
return useContext(ChatSurfaceContext);
}
/**
* Selecting a child for the panel and taking the foreground are one action:
* the panel and whatever else occupies that slot cannot both be open, so a
* selection made without the yield leaves the reader looking at the other one.
*
* `null` where there is no host — a search result renders the same card, but
* that route has no panel to open, so the card is not openable there.
*/
export function useOpenSubagentPanel(): ((selection: ActiveSubagentPanel) => void) | null {
const claimForeground = useOptionalChatSurface()?.claimForeground;
const setSelection = useSetAtom(activeSubagentPanel);
const requestFocus = useSetAtom(subagentPanelFocusRequest);
return useMemo(() => {
if (claimForeground == null) return null;
return (selection: ActiveSubagentPanel) => {
claimForeground();
setSelection(selection);
requestFocus((current) => current + 1);
};
}, [claimForeground, requestFocus, setSelection]);
}