mcp-native 1.0.0-beta.2 → 1.0.0
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.
- package/README.md +19 -4
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -1
- package/dist/mixed-surfaces.d.ts +4 -4
- package/dist/mixed-surfaces.d.ts.map +1 -1
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -26,17 +26,32 @@ semantic host extensions are already supported.
|
|
|
26
26
|
|
|
27
27
|
For the big picture, start with the [product guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/product-guide.md).
|
|
28
28
|
|
|
29
|
+
The v1 public API is finalized and ready for production integration under the
|
|
30
|
+
[1.x compatibility policy](https://github.com/pablospaniard/mcp-native/blob/main/docs/compatibility-policy.md).
|
|
31
|
+
|
|
29
32
|
## Install
|
|
30
33
|
|
|
31
|
-
|
|
34
|
+
Install the v1 package:
|
|
32
35
|
|
|
33
36
|
```bash
|
|
34
|
-
npm install mcp-native@
|
|
37
|
+
npm install mcp-native@1 react
|
|
35
38
|
```
|
|
36
39
|
|
|
37
40
|
React `>=18.1.0` is the only peer dependency. Native components and platform integrations are
|
|
38
41
|
supplied by the host application. The package is ESM-only and includes TypeScript declarations.
|
|
39
42
|
|
|
43
|
+
Use the `a2ui` and `reactNative` namespaces when composing both concise package APIs from this entry
|
|
44
|
+
point:
|
|
45
|
+
|
|
46
|
+
```ts
|
|
47
|
+
import { a2ui, reactNative } from "mcp-native";
|
|
48
|
+
|
|
49
|
+
const store = new a2ui.SurfaceStore();
|
|
50
|
+
const Surface = reactNative.HostSurface;
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Direct named re-exports and the previous prefixed compatibility aliases remain available.
|
|
54
|
+
|
|
40
55
|
Run the bundled local diagnostics or generate safe starting points without network access:
|
|
41
56
|
|
|
42
57
|
```bash
|
|
@@ -49,12 +64,12 @@ Scaffolds refuse to overwrite existing files. The extension command emits a clos
|
|
|
49
64
|
manifest and a local React Native registration skeleton; the application must still negotiate it
|
|
50
65
|
and supply explicit policy.
|
|
51
66
|
|
|
52
|
-
## A2UI
|
|
67
|
+
## Native A2UI path
|
|
53
68
|
|
|
54
69
|
The package re-exports the APIs needed to negotiate the project-owned binding, resolve official
|
|
55
70
|
v1 JSONL lifecycle envelopes, maintain bounded ordered surface state, apply explicit host
|
|
56
71
|
component/event/function policies, and mount the supported native subset through
|
|
57
|
-
`
|
|
72
|
+
`Surface`. The mounted surface keeps typed input edits renderer-local and returns validated
|
|
58
73
|
official action envelopes to a host callback; it never selects a return transport. See the
|
|
59
74
|
[A2UI package guide](https://github.com/pablospaniard/mcp-native/tree/main/packages/a2ui)
|
|
60
75
|
and the [`@mcp-native/react-native` adapter documentation](https://github.com/pablospaniard/mcp-native/tree/main/packages/react-native#a2ui-v1-render-plan-adapter).
|
package/dist/index.d.ts
CHANGED
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
|
package/dist/index.js
CHANGED
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
|
package/dist/mixed-surfaces.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type
|
|
1
|
+
import { type SurfaceState, type SurfaceValidationPolicy } from "@mcp-native/a2ui";
|
|
2
2
|
import { McpAppsBridge, type McpAppsNativeSandboxConfiguration, type McpAppsResource } from "@mcp-native/webview";
|
|
3
3
|
export declare const MCP_NATIVE_MIXED_MAX_REGIONS = 32;
|
|
4
4
|
export declare const MCP_NATIVE_MIXED_MAX_LISTENERS = 64;
|
|
@@ -36,7 +36,7 @@ interface McpNativeMixedSurfaceRegionBase {
|
|
|
36
36
|
export interface McpNativeMixedA2uiRegion extends McpNativeMixedSurfaceRegionBase {
|
|
37
37
|
readonly kind: "a2ui";
|
|
38
38
|
/** Reconstructed and revalidated snapshot owned by this host registration. */
|
|
39
|
-
readonly surface:
|
|
39
|
+
readonly surface: SurfaceState;
|
|
40
40
|
}
|
|
41
41
|
export interface McpNativeMixedMcpAppsRegion extends McpNativeMixedSurfaceRegionBase {
|
|
42
42
|
readonly kind: "mcp-app";
|
|
@@ -48,8 +48,8 @@ export type McpNativeMixedSurfaceRegion = McpNativeMixedA2uiRegion | McpNativeMi
|
|
|
48
48
|
export interface CreateMcpNativeMixedA2uiRegionOptions {
|
|
49
49
|
readonly id: string;
|
|
50
50
|
readonly accessibilityLabel: string;
|
|
51
|
-
readonly surface:
|
|
52
|
-
readonly policy:
|
|
51
|
+
readonly surface: SurfaceState;
|
|
52
|
+
readonly policy: SurfaceValidationPolicy;
|
|
53
53
|
readonly lifecycle?: McpNativeMixedSurfaceLifecycle;
|
|
54
54
|
}
|
|
55
55
|
export interface CreateMcpNativeMixedMcpAppsRegionOptions {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mixed-surfaces.d.ts","sourceRoot":"","sources":["../src/mixed-surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,
|
|
1
|
+
{"version":3,"file":"mixed-surfaces.d.ts","sourceRoot":"","sources":["../src/mixed-surfaces.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-native",
|
|
3
|
-
"version": "1.0.0
|
|
3
|
+
"version": "1.0.0",
|
|
4
4
|
"description": "Convenience package for the MCP Native runtime.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"a2ui",
|
|
@@ -48,10 +48,10 @@
|
|
|
48
48
|
"access": "public"
|
|
49
49
|
},
|
|
50
50
|
"dependencies": {
|
|
51
|
-
"@mcp-native/a2ui": "^1.0.0
|
|
52
|
-
"@mcp-native/core": "^1.0.0
|
|
53
|
-
"@mcp-native/react-native": "^1.0.0
|
|
54
|
-
"@mcp-native/webview": "^1.0.0
|
|
51
|
+
"@mcp-native/a2ui": "^1.0.0",
|
|
52
|
+
"@mcp-native/core": "^1.0.0",
|
|
53
|
+
"@mcp-native/react-native": "^1.0.0",
|
|
54
|
+
"@mcp-native/webview": "^1.0.0"
|
|
55
55
|
},
|
|
56
56
|
"peerDependencies": {
|
|
57
57
|
"react": ">=18.1.0"
|