@fungi.computer/graft 0.2.31 → 0.2.33

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 +54 -13
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -1,25 +1,24 @@
1
1
  # Graft (`@fungi.computer/graft`)
2
2
 
3
- This package presents an authorized Shiitake Session through the stable Agent
4
- Client Protocol (ACP) v1. Editor and host integrations use it to create, load,
5
- prompt, and observe Sessions while the host remains responsible for
6
- authorization.
3
+ Graft lets code editors that support the Agent Client Protocol, such as Zed,
4
+ open and talk to a Fungi agent conversation. It is for people who build their
5
+ own host.
6
+
7
+ ```mermaid
8
+ flowchart LR
9
+ Editor[ACP editor] <-->|ACP v1| Graft
10
+ Graft -->|authorized directory| Host[Your host]
11
+ Host --> Session[Shiitake Session]
12
+ ```
7
13
 
8
- Just want Fungi in Zed or another ACP editor? Run `fungi acp` — see
9
- [Use Fungi in your editor](https://docs.fungi.computer/guides/use-fungi-in-your-editor/).
10
- Graft is for people embedding ACP in their own host.
14
+ ## Quick start
11
15
 
12
- ## Install or set up
16
+ Install it:
13
17
 
14
18
  ```sh
15
19
  npm install @fungi.computer/graft
16
20
  ```
17
21
 
18
- Strict TypeScript consumers also install `@modelcontextprotocol/sdk@1.30.0`: the
19
- transitive Google GenAI declarations reference this optional peer.
20
-
21
- ## Quick start
22
-
23
22
  Just want Fungi in Zed or another ACP editor? Run `fungi acp` — see
24
23
  [Use Fungi in your editor](https://docs.fungi.computer/guides/use-fungi-in-your-editor/).
25
24
  Graft is for people embedding ACP in their own host.
@@ -70,6 +69,48 @@ needs no model or credentials. The packed runtime proof in
70
69
  Node. [`test/index.test.ts`](test/index.test.ts) additionally proves Session
71
70
  creation, prompting and cleanup through the maintained ACP client.
72
71
 
72
+ ## Common tasks
73
+
74
+ ### Try it in an editor without writing code
75
+
76
+ Run `fungi acp`. See
77
+ [Use Fungi in your editor](https://docs.fungi.computer/guides/use-fungi-in-your-editor/).
78
+
79
+ ### Start an ACP server
80
+
81
+ `createShiitakeAcpServer` takes your authorized Session directory. See the Quick
82
+ start.
83
+
84
+ ### See what the editor can do
85
+
86
+ See [Editor capabilities](#editor-capabilities).
87
+
88
+ ### Know the limits
89
+
90
+ See Limits and errors.
91
+
92
+ ## Reference
93
+
94
+ ### Overview
95
+
96
+ This package presents an authorized Shiitake Session through the stable Agent
97
+ Client Protocol (ACP) v1. Editor and host integrations use it to create, load,
98
+ prompt, and observe Sessions while the host remains responsible for
99
+ authorization.
100
+
101
+ Just want Fungi in Zed or another ACP editor? Run `fungi acp` — see
102
+ [Use Fungi in your editor](https://docs.fungi.computer/guides/use-fungi-in-your-editor/).
103
+ Graft is for people embedding ACP in their own host.
104
+
105
+ ## Install or set up
106
+
107
+ ```sh
108
+ npm install @fungi.computer/graft
109
+ ```
110
+
111
+ Strict TypeScript consumers also install `@modelcontextprotocol/sdk@1.30.0`: the
112
+ transitive Google GenAI declarations reference this optional peer.
113
+
73
114
  ## Core concepts
74
115
 
75
116
  - **The directory owns access.** Its `create` and `load` methods return a
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fungi.computer/graft",
3
- "version": "0.2.31",
3
+ "version": "0.2.33",
4
4
  "description": "ACP v1 projection for an authorized Shiitake Session",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -24,8 +24,8 @@
24
24
  "dependencies": {
25
25
  "@agentclientprotocol/sdk": "1.7.0",
26
26
  "@fungi.computer/cairn": "0.1.0",
27
- "@fungi.computer/mule": "0.2.5",
28
- "@fungi.computer/shiitake": "0.20.1"
27
+ "@fungi.computer/mule": "0.2.7",
28
+ "@fungi.computer/shiitake": "0.20.3"
29
29
  },
30
30
  "devDependencies": {
31
31
  "@types/node": "24.13.3",