@ggui-ai/mcp-apps-react-native 0.23.0 → 0.24.0

package/README.md

@@ -1,6 +1,6 @@
 # @ggui-ai/mcp-apps-react-native
 
-React Native SDK for [ggui](https://ggui.ai) — the interface layer
+MCP Apps host helper for React Native, from [ggui](https://ggui.ai) — the interface layer
 between AI agents and humans. Agents describe UIs in natural language
 over MCP; ggui generates ephemeral interfaces. This package lets you
 embed those interfaces in a React Native or Expo app.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ggui-ai/mcp-apps-react-native",
-  "version": "0.23.0",
-  "description": "React Native SDK for ggui — components and hooks for embedding agent-generated UIs in mobile apps.",
+  "version": "0.24.0",
+  "description": "React Native host helper for MCP Apps — components and hooks for embedding agent-generated UIs in mobile apps.",
   "keywords": [
     "ggui",
     "react-native",
@@ -9,7 +9,7 @@
     "mcp",
     "ai-agent",
     "generative-ui",
-    "sdk"
+    "mcp-apps"
   ],
   "license": "Apache-2.0",
   "homepage": "https://github.com/ggui-ai/ggui/tree/main/packages/mcp-apps-react-native",
@@ -58,9 +58,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.7.2",
-    "@ggui-ai/design": "0.23.0",
-    "@ggui-ai/iframe-runtime": "0.23.0",
-    "@ggui-ai/protocol": "0.23.0"
+    "@ggui-ai/design": "0.24.0",
+    "@ggui-ai/protocol": "0.24.0",
+    "@ggui-ai/iframe-runtime": "0.24.0"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.27.0",

package/src/components/GguiProvider.tsx

@@ -72,7 +72,7 @@ export interface GguiProviderProps {
    * (e.g., react-native-permissions, expo-permissions, or a custom dialog).
    *
    * @param permission - The Web Permissions API name being requested
-   *   (e.g., `'camera'`, `'microphone'`, `'geolocation'`). The SDK
+   *   (e.g., `'camera'`, `'microphone'`, `'geolocation'`). The helper
    *   pre-validates the name against `KNOWN_PERMISSION_NAMES` before
    *   invoking this handler, so an unknown name surfaces as a
    *   `UnknownPermissionNameError` to the caller without ever
@@ -110,7 +110,7 @@ function detectRNInterfaceContext(): InterfaceContext {
 }
 
 /**
- * Root provider for the ggui React Native SDK.
+ * Root provider for the React Native host helper.
  *
  * Wraps the application with shared configuration needed by all ggui hooks
  * and components. Auto-detects interface context from React Native Dimensions
@@ -143,7 +143,7 @@ export function GguiProvider({ appId, wsEndpoint, adapterImpls, interfaceContext
     async (permission: string): Promise<PermissionStatus> => {
       // Gate on `KNOWN_PERMISSION_NAMES` (the Web Permissions API
       // enum). With no host-advertised `AdapterType[]` allow-list,
-      // the SDK is the last line of defense against typos or
+      // the helper is the last line of defense against typos or
       // unsupported names slipping into the runtime cache.
       if (!KNOWN_PERMISSION_NAMES_SET.has(permission)) {
         throw new UnknownPermissionNameError({ observedName: permission });

package/src/context/GguiContext.ts

@@ -68,7 +68,7 @@ export interface GguiContextValue {
   /** Base URL for design system modules in WebView import map */
   designSystemUrl?: string;
   /**
-   * App config (endpointUrl, defaultShellType, etc). Mirrors the web SDK's
+   * App config (endpointUrl, defaultShellType, etc). Mirrors the web host helper's
    * context field — `useInvoke` reads `endpointUrl` from here when the
    * caller doesn't override it. Populated by {@link GguiProvider} via its
    * `appConfig` prop.
@@ -106,7 +106,7 @@ export function useGguiContext(): GguiContextValue {
  * for this capability — callers MUST handle that case (e.g. render
  * a fallback UI). Grant decisions live on `clientCapabilities.gadgets
  * [*].permission` and surface to the iframe via `Permissions-Policy`;
- * the SDK context just exposes whatever the host wired into
+ * the helper's context just exposes whatever the host wired into
  * `adapterImpls`.
  *
  * Mirrors {@link useAdapter} in `@ggui-ai/mcp-apps-react`. Capability packages

package/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * @ggui-ai/mcp-apps-react-native - React Native SDK for ggui
+ * @ggui-ai/mcp-apps-react-native - MCP Apps host helper for React Native
  *
  * Provides React Native components, hooks, and utilities for embedding ggui
  * agent interfaces in mobile applications. The host primitive is
@@ -78,7 +78,7 @@ export type {
 // ProtocolError typed union — the canonical shape for every failure
 // the renderer classifies outward. `<McpAppIframe onError>` surfaces
 // it; embedding apps pattern-match on `err.kind`. The sibling package
-// `@ggui-ai/iframe-runtime` owns the declaration; the RN SDK re-exports
+// `@ggui-ai/iframe-runtime` owns the declaration; this host helper re-exports
 // it at parity with `@ggui-ai/mcp-apps-react` so consumers have a single import
 // point per platform.
 export type {

package/src/invoke/useInvoke.ts

@@ -100,7 +100,7 @@ export interface UseInvokeOptions {
    *   - `ggui_render` / `ggui_update` / `ggui_handshake` — paired by
    *     `tool_use_id` with an inline `tool_result` block on the same
    *     assistant turn. Consumers watch for the pair and mount their
-   *     renderer (e.g. `<McpAppIframe>` on the web SDK) using the
+   *     renderer (e.g. this package's `<McpAppIframe>`) using the
    *     bootstrap metadata off the paired tool_result.
    *   - `ggui_render_blueprint` — a pure client tool (no server result to
    *     pair with); the consumer resolves the blueprint name locally.
@@ -409,7 +409,7 @@ function makeTransportError(message: string): InvokeError {
  * tool_result's content payload if one is present. Tolerant of arbitrary
  * nested shapes — agents may put the id directly on the result or under
  * a wrapper like `{ result: { hostSessionId } }`. Wire field and
- * SDK-side name are both `hostSessionId`.
+ * helper-side name are both `hostSessionId`.
  */
 function extractHostSessionIdFromContent(content: unknown): string | null {
   if (typeof content !== 'object' || content === null) return null;

package/src/types/react-test-renderer.d.ts

@@ -3,7 +3,7 @@
  *
  * `react-test-renderer@19` does not ship its own types, and there is no
  * matching `@types/react-test-renderer@19` on npm. We only need a tiny
- * surface (`create`, `act`, `ReactTestRenderer.toJSON()`) for the SDK's
+ * surface (`create`, `act`, `ReactTestRenderer.toJSON()`) for the package's
  * test files — full fidelity is not required.
  */
 declare module 'react-test-renderer' {