This release adds 3 notable features for engineering teams evaluating rollout.
✓ No known CVEs patched in this version
Topics
+12 more
Summary
AI summary@copilotkit/react-native adds React Native support, registerProxiedAgent enables frontend‑tool mounting against runtime agents, and BuiltInAgent gains per‑call header resolution.
Full changelog
CopilotKit v1.57.1
A patch release on the 1.57 line. Adds @copilotkit/react-native for using CopilotKit hooks in React Native apps, ships registerProxiedAgent for mounting frontend tools/context against a single runtime agent, adds a per-call getHeaders resolver to BuiltInAgent's MCP server config, and auto-mounts the IntelligenceIndicator pill when intelligence is configured on the runtime.
Install
npm install @copilotkit/[email protected] @copilotkit/[email protected] @copilotkit/[email protected]
Features
-
@copilotkit/react-native— New package for using CopilotKit in React Native apps. Ships a lightweightCopilotKitProvider(no DOM, CSS, Radix, Lit, or A2UI deps), aninstallStreamingFetch()XHR-based shim that givesresponse.body.getReader()support, and granular polyfills forReadableStream,TextEncoder, crypto,DOMException, andwindow.location. All hooks (useAgent,useFrontendTool,useHumanInTheLoop, etc.) re-export directly fromreact-coreover a shared context. Backed by an extraction ofCopilotKitContextanduseCopilotKitinto a standalone@copilotkit/react-core/v2/contextentry point so cross-platform consumers don't pull web-only deps via the barrel. (#3633)// index.js — entry point, before other imports import "@copilotkit/react-native/polyfills"; import { installStreamingFetch } from "@copilotkit/react-native"; installStreamingFetch(); // App.tsx import { CopilotKitProvider, useAgent } from "@copilotkit/react-native"; -
registerProxiedAgentin@copilotkit/core— New API for mounting a frontend-side agent (with frontend tools, context, render hooks) against a server-defined runtime agent.CopilotKitCore.registerProxiedAgent({ agentId, runtimeAgentId })mints aProxiedCopilotRuntimeAgentunder a local registry id and routes its outbound HTTP requests (/agent/<id>/run,/connect,/stop) to the named runtime agent. Returns{ agent, unregister }foruseEffectcleanup. Throws on duplicateagentId(collisions withagents__unsafe_dev_onlyor anotherregisterProxiedAgentare loud, not silent). Replaces the implicit per-thread agent cloning from earlier work, which has been reverted because it wiped agent state on tool calls — the registry now keeps a single agent per id. (#4629)const { copilotkit } = useCopilotKit(); useEffect(() => { const { unregister } = copilotkit.registerProxiedAgent({ agentId: "chat-1", // local registry id (subscriber bookkeeping) runtimeAgentId: "default", // runtime id (URL routing only) }); return unregister; }, [copilotkit]); // <CopilotChat agentId="chat-1" /> -
Configurable MCP server on
BuiltInAgent—@copilotkit/runtime/v2'sBuiltInAgentMCP config now accepts anauthToken(static Bearer shorthand) and agetHeadersresolver that runs on every outbound HTTP request — initialize,tools/list,tools/call, reconnects. The resolver receivesMCPRequestContext(requestHeaders,input,mcpServerUrl) so headers can be derived per request rather than baked into the client config. The MCP layer now sits directly on@ai-sdk/mcp(MCPClient,MCPTransport,OAuthClientProvider,OAuthTokens, andUnauthorizedErrorre-exported from@copilotkit/runtime/v2); the agent module no longer imports@modelcontextprotocol/sdkdirectly. Side-effect fix: SSE staticheadersnow reach the wire — the previous direct-SDK construction silently dropped them. (#4420)import { BuiltInAgent, INTELLIGENCE_USER_ID_HEADER, } from "@copilotkit/runtime/v2"; new BuiltInAgent({ model: "openai/gpt-4o", mcpServers: [{ type: "http", url: `${process.env.INTELLIGENCE_API_URL}/mcp`, authToken: process.env.INTELLIGENCE_API_KEY!, getHeaders: ({ requestHeaders }) => { const userId = requestHeaders[INTELLIGENCE_USER_ID_HEADER]?.trim(); if (!userId) throw new Error("missing user-id"); return { [INTELLIGENCE_USER_ID_HEADER]: userId }; }, }], }); -
IntelligenceIndicatorauto-mounts in@copilotkit/react-core— When intelligence is configured on the runtime (/inforeturnsintelligence),CopilotChatMessageViewmounts a "Using CopilotKit Intelligence" pill on the canonical message slot — no factory, no provider, norenderCustomMessagesregistration. The indicator self-gates: only the last message of the latest in-flight run with a tool call matchingDEFAULT_TOOL_PATTERNS(currently[/^bash$/]) renders. Per-instance phase machine (spinner→ debouncedcheck→fading→hidden) absorbs step-boundaryRUN_FINISHED → RUN_STARTEDblips. Pill width follows content; gate no longer depends ongetRunIdForMessage; the indicator stays through tool-result interleaving. (#4632)
Dependency hygiene
- Bump
@copilotkit/license-verifier0.2.0 → 0.4.0 — applied inpackages/runtime,packages/shared, and the root pnpmoverridesblock. (#4699)
Build / packaging
@copilotkit/react-nativewired into the release system — added to changesets configuration and the release pipeline so the new package is versioned and published alongside the rest of the monorepo. (9328de4a)
Packages republished at 1.57.1
@copilotkit/runtime, @copilotkit/react-core, @copilotkit/react-ui, @copilotkit/react-native, @copilotkit/core, @copilotkit/shared, @copilotkit/runtime-client-gql, @copilotkit/sdk-js, @copilotkit/voice, @copilotkit/web-inspector, @copilotkit/a2ui-renderer, @copilotkit/react-textarea, and @copilotkit/sqlite-runner.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About CopilotKit
The Frontend Stack for Agents & Generative UI. React + Angular. Makers of the AG-UI Protocol
Related context
Related tools
Beta — feedback welcome: [email protected]