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.
Files changed (2) hide show
  1. package/README.md +37 -1
  2. 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`](../agent) contract into Agent Native actions.
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.0",
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.0"
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.0"
51
+ "foldkit-agent": "0.2.1"
52
52
  },
53
53
  "scripts": {
54
54
  "build": "tsdown",