react-core

This skill is a reference index for @copilotkit/react-core, the React frontend half of CopilotKit v2. It mounts a provider, speaks the AG-UI protocol over SSE to a runtime (or directly to CopilotKit Intelligence in SPA mode), and exposes hooks for every interaction surface. It solves the problem of correctly composing CopilotKit's frontend across framework targets (Next.js App Router, React Router v7, TanStack Start, and SPAs) while steering developers away from common hallucinations — for example, that chat components ship from react-core/v2 rather than react-ui, and that CopilotPanel does not exist.

The skill frames the package as three composable shells: a provider shell (the CopilotKit provider carrying runtimeUrl or publicLicenseKey, headers, credentials, properties, onError, and debug options), a chat shell (CopilotChat/CopilotPopup/CopilotSidebar or a composed CopilotChatView with slot primitives), and a hook shell for agent-scoped registration. It indexes a broad set of reference files covering provider setup, chat components, agent access and switching (useAgent, useAgentContext, useCapabilities), durable Intelligence threads (useThreads), browser-side tools (useFrontendTool), tool-call rendering, human-in-the-loop gating, file attachments, suggestion pills, and activity/custom message renderers. The attachments reference, for instance, documents upload configuration, custom S3/presigned-URL backends, and frequent mistakes like passing maxSize in the wrong units.

It targets React developers integrating CopilotKit v2 into production apps who need precise, source-grounded API details and want to load only the reference matching their current task rather than absorbing the whole package.