feat(react-native): export full v2 API surface with attachment support

15+ type re-exports from headless layer. expo-document-picker and
expo-file-system as optional peer deps. InterruptEvent,
ReactFrontendTool, ReactHumanInTheLoop added to headless.ts.

Author: jpr5

packages/react-core/src/v2/headless.ts

@@ -26,7 +26,13 @@ export { useAgent, type UseAgentUpdate } from "./hooks/use-agent";
 export { useFrontendTool } from "./hooks/use-frontend-tool";
 export { useComponent } from "./hooks/use-component";
 export { useHumanInTheLoop } from "./hooks/use-human-in-the-loop";
-export { useInterrupt, type UseInterruptConfig } from "./hooks/use-interrupt";
+export {
+  useInterrupt,
+  type UseInterruptConfig,
+  type InterruptEvent,
+  type InterruptHandlerProps,
+  type InterruptRenderProps,
+} from "./hooks/use-interrupt";
 export { useSuggestions } from "./hooks/use-suggestions";
 export { useConfigureSuggestions } from "./hooks/use-configure-suggestions";
 export {
@@ -40,3 +46,19 @@ export {
   type UseThreadsInput,
   type UseThreadsResult,
 } from "./hooks/use-threads";
+
+export {
+  useRenderTool,
+  type RenderToolProps,
+  type RenderToolInProgressProps,
+  type RenderToolExecutingProps,
+  type RenderToolCompleteProps,
+} from "./hooks/use-render-tool";
+export { defineToolCallRenderer } from "./types/defineToolCallRenderer";
+
+// Platform-agnostic types
+export type { ReactFrontendTool } from "./types/frontend-tool";
+export type { ReactHumanInTheLoop } from "./types/human-in-the-loop";
+
+// Platform-agnostic capability introspection
+export { useCapabilities } from "./hooks/use-capabilities";

packages/react-native/package.json

@@ -18,6 +18,7 @@
   },
   "type": "module",
   "sideEffects": [
+    "./dist/index.*",
     "./dist/polyfills.*",
     "./dist/polyfills/**/*"
   ],
@@ -69,6 +70,7 @@
     "unlink:global": "pnpm unlink --global"
   },
   "dependencies": {
+    "@ag-ui/client": "0.0.53",
     "@copilotkit/core": "workspace:*",
     "@copilotkit/react-core": "workspace:*",
     "@copilotkit/shared": "workspace:*",
@@ -86,7 +88,21 @@
     "vitest": "^3.2.4"
   },
   "peerDependencies": {
+    "expo-document-picker": ">=12.0.0",
+    "expo-file-system": ">=17.0.0",
     "react": "^18 || ^19",
-    "react-native": ">=0.70"
+    "react-native": ">=0.70",
+    "zod": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "expo-document-picker": {
+      "optional": true
+    },
+    "expo-file-system": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
   }
 }

packages/react-native/src/index.ts

@@ -4,16 +4,51 @@
  * React Native bindings for CopilotKit. Provides a lightweight provider
  * and re-exports platform-agnostic hooks from @copilotkit/react-core.
  *
+ * Polyfills (DOMException, ReadableStream, TextEncoder, etc.) are
+ * auto-imported when this module loads -- no manual
+ * `import "@copilotkit/react-native/polyfills"` needed.
+ *
  * Quick start:
  * ```tsx
  * import { CopilotKitProvider, useAgent, useCopilotKit } from "@copilotkit/react-native";
  * ```
  */
 
+// Auto-install polyfills so consumers don't need a manual import.
+// Must run before any CopilotKit code that relies on ReadableStream / fetch streaming.
+import "./polyfills";
+
 // React Native provider (no web dependencies)
 export { CopilotKitProvider } from "./CopilotKitProvider";
 export type { CopilotKitNativeProviderProps } from "./CopilotKitProvider";
 
+// Provider props alias (mirrors web's CopilotKitProviderProps)
+export type { CopilotKitNativeProviderProps as CopilotKitProviderProps } from "./CopilotKitProvider";
+
+// Headless chat components (no DOM, consumer provides UI)
+export { CopilotChat, useCopilotChatContext } from "./CopilotChat";
+export type { CopilotChatProps, CopilotChatContextValue } from "./CopilotChat";
+export { CopilotModal } from "./CopilotModal";
+export type { CopilotModalProps } from "./CopilotModal";
+
+// Native attachments hook and types
+export { useAttachments } from "./hooks/use-attachments";
+export type {
+  NativeAttachmentsConfig,
+  NativeFileInput,
+  UseNativeAttachmentsProps,
+  UseNativeAttachmentsReturn,
+} from "./hooks/use-attachments";
+
+// Pre-built UI components
+export { CopilotSidebar } from "./CopilotSidebar";
+export type {
+  CopilotSidebarProps,
+  CopilotSidebarHandle,
+} from "./CopilotSidebar";
+export { CopilotPopup } from "./CopilotPopup";
+export type { CopilotPopupProps, CopilotPopupHandle } from "./CopilotPopup";
+
 // Re-export context and hooks from react-core (platform-agnostic)
 export {
   useCopilotKit,
@@ -34,11 +69,50 @@ export {
   useConfigureSuggestions,
   useAgentContext,
   useThreads,
+  useRenderTool,
+  useCapabilities,
+  defineToolCallRenderer,
+  CopilotChatDefaultLabels,
   type UseAgentUpdate,
+  type UseInterruptConfig,
+  type AgentContextInput,
+  type JsonSerializable,
+  type Thread,
+  type UseThreadsInput,
+  type UseThreadsResult,
+  type CopilotChatLabels,
+  type CopilotChatConfigurationValue,
+  type InterruptEvent,
+  type InterruptHandlerProps,
+  type InterruptRenderProps,
+  type ReactFrontendTool,
+  type ReactHumanInTheLoop,
+  type RenderToolProps,
+  type RenderToolInProgressProps,
+  type RenderToolExecutingProps,
+  type RenderToolCompleteProps,
 } from "@copilotkit/react-core/v2/headless";
 
+// useRenderToolCall — web-specific (depends on DOM elements via DefaultToolCallRenderer)
+// useRenderCustomMessages — web-specific (tightly coupled to web chat UI rendering pipeline)
+// useRenderActivityMessage — web-specific (tightly coupled to web chat UI rendering pipeline)
+// useDefaultRenderTool — web-specific (DefaultToolCallRenderer uses <div>, <svg>, etc.)
+
 // Re-export core types commonly needed
-export {
-  type CopilotKitCoreRuntimeConnectionStatus,
-  type CopilotKitCoreErrorCode,
+export type {
+  CopilotKitCoreRuntimeConnectionStatus,
+  CopilotKitCoreErrorCode,
+  Suggestion,
+  FrontendTool,
+  ToolCallStatus,
 } from "@copilotkit/core";
+
+// Re-export AG-UI types for consumer convenience (matches web SDK surface)
+export type {
+  Message,
+  AssistantMessage,
+  ToolCall,
+  ToolMessage,
+  AbstractAgent,
+  AgentCapabilities,
+} from "@ag-ui/client";