foldkit-agent-native 0.2.0 → 0.2.1
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 +37 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,11 +1,26 @@
|
|
|
1
1
|
# `foldkit-agent-native`
|
|
2
2
|
|
|
3
|
-
Compiles a [`foldkit-agent`](
|
|
3
|
+
Compiles a [`foldkit-agent`](https://github.com/doeixd/foldkit-plus/tree/main/packages/agent) contract into
|
|
4
|
+
[Agent Native](https://github.com/BuilderIO/agent-native) actions.
|
|
5
|
+
|
|
6
|
+
Agent Native is a framework for describing what an application can do as
|
|
7
|
+
registered **actions** an agent host can call. This package derives those
|
|
8
|
+
actions from the contract, so the capabilities an agent gets are exactly the
|
|
9
|
+
Messages `update` already handles, and the generated `run` only dispatches.
|
|
4
10
|
|
|
5
11
|
It is checked against `@agent-native/core@0.177.1`; the integration suite uses
|
|
6
12
|
the real package registry, tool runtime, and schema wrapper. Full HTTP/MCP/A2A
|
|
7
13
|
deployments remain outside this package's test suite.
|
|
8
14
|
|
|
15
|
+
## Install
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
pnpm add foldkit-agent foldkit-agent-native
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
`foldkit`, `effect`, `foldkit-agent`, and `@agent-native/core` are peer
|
|
22
|
+
dependencies.
|
|
23
|
+
|
|
9
24
|
## What it does
|
|
10
25
|
|
|
11
26
|
```ts
|
|
@@ -117,3 +132,24 @@ This completes the bounded proof of concept in
|
|
|
117
132
|
[issue #22](https://github.com/doeixd/foldkit-plus/issues/22), not a claim that
|
|
118
133
|
every Agent Native subsystem is independently reusable. A full deployment test
|
|
119
134
|
of the HTTP, MCP, A2A, CLI, auth, and UI surfaces remains future work.
|
|
135
|
+
|
|
136
|
+
## Choosing an adapter
|
|
137
|
+
|
|
138
|
+
All four serve the same contract, so serving two at once is two calls, not two
|
|
139
|
+
definitions.
|
|
140
|
+
|
|
141
|
+
| Where the agent runs | Adapter |
|
|
142
|
+
| --- | --- |
|
|
143
|
+
| In the page, beside the user | [`foldkit-agent-webmcp`](https://github.com/doeixd/foldkit-plus/tree/main/packages/agent-webmcp) |
|
|
144
|
+
| An external MCP client, over stdio or HTTP | [`foldkit-agent-mcp`](https://github.com/doeixd/foldkit-plus/tree/main/packages/agent-mcp) |
|
|
145
|
+
| Another agent, over A2A | [`foldkit-agent-a2a`](https://github.com/doeixd/foldkit-plus/tree/main/packages/agent-a2a) |
|
|
146
|
+
| An Agent Native host | [`foldkit-agent-native`](https://github.com/doeixd/foldkit-plus/tree/main/packages/agent-native) |
|
|
147
|
+
|
|
148
|
+
## See also
|
|
149
|
+
|
|
150
|
+
- [The agents guide](https://github.com/doeixd/foldkit-plus/blob/main/docs/agents.md) — what an agent may see and
|
|
151
|
+
do, and why a capability is a Message.
|
|
152
|
+
- [`foldkit-agent`](https://github.com/doeixd/foldkit-plus/tree/main/packages/agent) — the contract this adapter
|
|
153
|
+
serves, and where `Agent.bind` produces the runtime it takes.
|
|
154
|
+
- [`examples/todo`](https://github.com/doeixd/foldkit-plus/tree/main/examples/todo) — a worked contract with a
|
|
155
|
+
hand-written host.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "foldkit-agent-native",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "Agent Native adapter for foldkit-agent. Compiles an exposed Foldkit contract into Agent Native actions.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"foldkit",
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
"@agent-native/core": "0.177.1",
|
|
41
41
|
"effect": "^4.0.0-rc.112",
|
|
42
42
|
"foldkit": "^0.158.2",
|
|
43
|
-
"foldkit-agent": "^0.2.
|
|
43
|
+
"foldkit-agent": "^0.2.1"
|
|
44
44
|
},
|
|
45
45
|
"devDependencies": {
|
|
46
46
|
"@agent-native/core": "0.177.1",
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
"foldkit": "0.158.2",
|
|
49
49
|
"tsdown": "^0.23.0",
|
|
50
50
|
"typescript": "^5.7.2",
|
|
51
|
-
"foldkit-agent": "0.2.
|
|
51
|
+
"foldkit-agent": "0.2.1"
|
|
52
52
|
},
|
|
53
53
|
"scripts": {
|
|
54
54
|
"build": "tsdown",
|