mcp-native 0.9.1 → 0.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +15 -34
  3. package/package.json +11 -8
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 MCP Native contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -13,23 +13,15 @@
13
13
 
14
14
  </div>
15
15
 
16
- > **Pre-1.0 release candidate:** MCP Native `0.9.x` is feature-complete for the documented React
17
- > Native host scope, and the proposed `1.0.0` API is frozen. The stable compatibility guarantee
18
- > begins after the remaining independent review and release gates are complete. Shipping hosts must
19
- > still audit their policies, component mappings, permissions, WebView integration, and platform
20
- > behavior.
16
+ `mcp-native` is the convenient way to use the runtime, A2UI, React Native, mixed-surface, and WebView
17
+ APIs from one package. It re-exports the focused `@mcp-native/*` layers while leaving transport
18
+ adapters as a separate installation choice.
21
19
 
22
- > **Compatibility:** the documented tool/resource and authorization boundary preserves MCP
23
- > `2026-07-28` fields and passes its pinned conformance coverage. The package exposes the
24
- > feature-scoped A2UI v1.0 Candidate profile and retains custom `0.1` APIs only as deprecated
25
- > migration support; this is not an unqualified A2UI renderer claim. It also re-exports the
26
- > documented stable MCP Apps `2026-01-26` native host-adapter profile. See the [A2UI profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/a2ui-v1-conformance.md), [MCP Apps profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/mcp-apps-compatibility.md), and [standards matrix](https://github.com/pablospaniard/mcp-native/blob/main/docs/standards-compatibility.md).
20
+ The current 0.9 line contains the React Native feature set planned for 1.0 and is ready to try in an
21
+ integration. New work should use A2UI v1 Candidate or the stable MCP Apps `2026-01-26` host flow;
22
+ the custom A2UI 0.1 APIs live under `/legacy` for migration.
27
23
 
28
- `mcp-native` is the convenience package for the runtime and UI APIs. It re-exports the runtime contracts, A2UI v1 lifecycle/capability/renderer-message APIs, trusted native renderer and hooks, host-owned mixed-surface coordinator, deprecated custom surface migration APIs, and policy-gated WebView compatibility primitives from focused `@mcp-native/*` packages. Transport adapters are installed separately.
29
-
30
- Read the human-oriented [product guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/product-guide.md)
31
- and [mixed-surface guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/mixed-surfaces.md)
32
- before the API examples.
24
+ For the big picture, start with the [product guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/product-guide.md).
33
25
 
34
26
  ## Install
35
27
 
@@ -49,20 +41,18 @@ official action envelopes to a host callback; it never selects a return transpor
49
41
  [complete v1 host-flow example](https://github.com/pablospaniard/mcp-native#a2ui-v1-candidate-host-flow)
50
42
  and the [`@mcp-native/react-native` adapter documentation](https://github.com/pablospaniard/mcp-native/tree/main/packages/react-native#a2ui-v1-render-plan-adapter).
51
43
 
52
- ## Deprecated `0.1` proof-model preview
44
+ ## Legacy custom `0.1` migration
53
45
 
54
46
  For `0.9.x`, migrate these imports to `mcp-native/legacy`. Root aliases are removed at `1.0.0`;
55
47
  the explicit legacy subpath stays frozen for migration and security fixes.
56
48
 
57
49
  ```tsx
50
+ import { McpNativeRuntime, createAllowlistActionPolicy, type McpClient } from "mcp-native";
58
51
  import {
59
52
  McpNativeSurface,
60
- McpNativeRuntime,
61
- createAllowlistActionPolicy,
62
53
  parseA2uiSurface,
63
54
  useMcpNativeActionDispatcher,
64
- type McpClient,
65
- } from "mcp-native";
55
+ } from "mcp-native/legacy";
66
56
  import { Button, Text, TextInput, View } from "react-native";
67
57
 
68
58
  const components = { Button, Text, TextInput, View };
@@ -127,7 +117,7 @@ Install an individual package instead when you only need one layer.
127
117
 
128
118
  Use the separately installable [`@mcp-native/mcp`](https://github.com/pablospaniard/mcp-native/tree/main/packages/mcp) package to connect these APIs to the official MCP TypeScript SDK without forcing that SDK dependency on every `mcp-native` consumer.
129
119
 
130
- ## Implemented in `0.9.0`
120
+ ## Included in the current 0.9 line
131
121
 
132
122
  - transport-independent MCP runtime contracts;
133
123
  - isolated migration support for the deprecated custom `0.1` surface;
@@ -155,19 +145,10 @@ Use the separately installable [`@mcp-native/mcp`](https://github.com/pablospani
155
145
  - pinned current-protocol integration coverage through the SDK HTTP handler/fetch path;
156
146
  - ESM exports, TypeScript declarations, automated tests, and signed npm provenance.
157
147
 
158
- Release `0.9.0` adds host-owned mixed native/MCP Apps composition, a production-shaped reference
159
- host, and the frozen `1.0.0` release-candidate API. Release `0.8.0` added policy-gated `Video` and
160
- `AudioPlayer`, completed the pinned A2UI basic catalog, and added exact namespaced manifests and
161
- local registration for compiled host extensions. Release `0.7.0` added the
162
- non-media catalog, typed renderer-local bindings, bounded formatting and validation, host-callback
163
- actions, required image grants, policy-gated HTTP(S) `openUrl`, and exact installed-subset
164
- discovery. Release `0.6.0` added bounded consent, expiring/revocable host-owned grants, interactive
165
- OAuth, scope history, lifecycle coordination, actionable states, and redacted operations. The
166
- packages intentionally do not claim MCP operations or A2UI features outside their documented
167
- profiles. Full streaming host integration, transport placement for A2UI capability objects, and
168
- separate non-blocking Expo Go integration PoCs remain deferred or excluded work. Follow the
169
- [roadmap](https://github.com/pablospaniard/mcp-native/blob/main/docs/roadmap.md) for exact claim
170
- boundaries.
148
+ For the release-by-release history, see the
149
+ [changelog](https://github.com/pablospaniard/mcp-native/blob/main/CHANGELOG.md). The runnable
150
+ [Expo Go todo app](../../examples/expo-go-todolist/README.md) shows the main A2UI and React Native
151
+ pieces working together.
171
152
 
172
153
  ## Security model
173
154
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-native",
3
- "version": "0.9.1",
3
+ "version": "0.9.2",
4
4
  "description": "Convenience package for the MCP Native runtime.",
5
5
  "keywords": [
6
6
  "a2ui",
@@ -21,6 +21,7 @@
21
21
  },
22
22
  "files": [
23
23
  "dist",
24
+ "LICENSE",
24
25
  "README.md"
25
26
  ],
26
27
  "type": "module",
@@ -30,25 +31,27 @@
30
31
  "exports": {
31
32
  ".": {
32
33
  "types": "./dist/index.d.ts",
33
- "import": "./dist/index.js"
34
+ "import": "./dist/index.js",
35
+ "default": "./dist/index.js"
34
36
  },
35
37
  "./legacy": {
36
38
  "types": "./dist/legacy.d.ts",
37
- "import": "./dist/legacy.js"
39
+ "import": "./dist/legacy.js",
40
+ "default": "./dist/legacy.js"
38
41
  }
39
42
  },
40
43
  "publishConfig": {
41
44
  "access": "public"
42
45
  },
43
46
  "dependencies": {
44
- "@mcp-native/a2ui": "^0.9.1",
45
- "@mcp-native/core": "^0.9.1",
46
- "@mcp-native/react-native": "^0.9.1",
47
- "@mcp-native/webview": "^0.9.1"
47
+ "@mcp-native/a2ui": "^0.9.2",
48
+ "@mcp-native/core": "^0.9.2",
49
+ "@mcp-native/react-native": "^0.9.2",
50
+ "@mcp-native/webview": "^0.9.2"
48
51
  },
49
52
  "peerDependencies": {
50
53
  "react": ">=18.3.1 <20",
51
- "react-native": ">=0.87.0 <1"
54
+ "react-native": ">=0.86.0 <1"
52
55
  },
53
56
  "peerDependenciesMeta": {
54
57
  "react-native": {