aixyz 0.35.0 → 0.36.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 +1 -0
- package/docs/templates/basic/with-vercel-blob.mdx +61 -0
- package/docs/templates/overview.mdx +3 -0
- package/examples/boilerplate/AGENTS.md +9 -0
- package/examples/boilerplate/CLAUDE.md +1 -0
- package/examples/boilerplate/app/agent.ts +2 -1
- package/examples/boilerplate/package.json +1 -1
- package/examples/with-custom-facilitator/package.json +1 -1
- package/examples/with-express/package.json +1 -1
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -137,6 +137,7 @@ That's it. Run `bun run dev` and aixyz auto-generates the server, wires up A2A +
|
|
|
137
137
|
| [`sub-agents`](./examples/sub-agents/) | Multiple A2A endpoints from one deployment |
|
|
138
138
|
| [`with-tests`](./examples/with-tests/) | Agent with test examples |
|
|
139
139
|
| [`fake-llm`](./examples/fake-llm/) | Fully deterministic testing with `fake()` model |
|
|
140
|
+
| [`with-vercel-blob`](./examples/with-vercel-blob/) | MCP-only txt storage using Vercel Blob |
|
|
140
141
|
|
|
141
142
|
## CLI
|
|
142
143
|
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Vercel Blob"
|
|
3
|
+
description: "MCP-only template that stores text on Vercel Blob"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<Info>
|
|
7
|
+
**Source:** [`examples/with-vercel-blob`](https://github.com/AgentlyHQ/aixyz/tree/main/examples/with-vercel-blob)
|
|
8
|
+
</Info>
|
|
9
|
+
|
|
10
|
+
## Overview
|
|
11
|
+
|
|
12
|
+
This template exposes two MCP tools, `put-text` and `get-text`, that store and retrieve text using Vercel Blob. Each call is priced at `$0.001` via x402. There is **no** `app/agent.ts` — the server only serves `/mcp`.
|
|
13
|
+
|
|
14
|
+
## Project Structure
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
with-vercel-blob/
|
|
18
|
+
├── aixyz.config.ts # Agent metadata + x402 config
|
|
19
|
+
├── app/
|
|
20
|
+
│ ├── icon.svg # Template icon
|
|
21
|
+
│ └── tools/
|
|
22
|
+
│ ├── put-text.ts # Write txt blob
|
|
23
|
+
│ └── get-text.ts # Read txt blob
|
|
24
|
+
├── package.json
|
|
25
|
+
├── tsconfig.json
|
|
26
|
+
└── vercel.json
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Tools
|
|
30
|
+
|
|
31
|
+
### `put-text`
|
|
32
|
+
|
|
33
|
+
- Input: `text` (string, 1–50k chars)
|
|
34
|
+
- Returns: `{ id }` — a UUID identifying the stored text
|
|
35
|
+
|
|
36
|
+
### `get-text`
|
|
37
|
+
|
|
38
|
+
- Input: `id` (UUID returned by `put-text`)
|
|
39
|
+
- Returns: `{ id, text }`
|
|
40
|
+
|
|
41
|
+
## Environment
|
|
42
|
+
|
|
43
|
+
Set a Vercel Blob read/write token before running locally (required by both tools):
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
echo 'BLOB_READ_WRITE_TOKEN=...' >> .env.local
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Payment
|
|
50
|
+
|
|
51
|
+
`put-text` and `get-text` each charge `$0.001` per call using the x402 settings in `aixyz.config.ts` (Base mainnet in production, Base Sepolia in development).
|
|
52
|
+
|
|
53
|
+
## Running locally
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
cd examples/with-vercel-blob
|
|
57
|
+
bun install
|
|
58
|
+
bun run dev
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Connect any MCP client (Claude Desktop, VS Code MCP extension, etc.) to `http://localhost:3000/mcp` and call `put-text` / `get-text` with the schemas above.
|
|
@@ -29,6 +29,9 @@ Standard agents using `app/agent.ts` + `app/tools/`. No custom server — the se
|
|
|
29
29
|
<Card title="Chainlink" icon="link" href="/templates/basic/chainlink">
|
|
30
30
|
Chainlink price feeds on Ethereum mainnet.
|
|
31
31
|
</Card>
|
|
32
|
+
<Card title="Vercel Blob" icon="file-lines" href="/templates/basic/with-vercel-blob">
|
|
33
|
+
MCP-only txt storage with put-text/get-text using @vercel/blob.
|
|
34
|
+
</Card>
|
|
32
35
|
</CardGroup>
|
|
33
36
|
|
|
34
37
|
## Advanced
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
<!-- BEGIN:aixyz-agent-rules -->
|
|
2
|
+
|
|
3
|
+
# aixyz: ALWAYS read docs before coding
|
|
4
|
+
|
|
5
|
+
Before any aixyz work, find and read the relevant doc in `node_modules/aixyz/docs/`.
|
|
6
|
+
And you can read `node_modules/aixyz/examples/` for examples that you can reference.
|
|
7
|
+
Your training data is outdated — the docs are the source of truth.
|
|
8
|
+
|
|
9
|
+
<!-- END:aixyz-agent-rules -->
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
See [AGENTS.md](./AGENTS.md) for the local coding rules that apply to this example.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "aixyz",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.36.0",
|
|
4
4
|
"description": "Payment-native SDK for AI Agent",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai",
|
|
@@ -41,9 +41,9 @@
|
|
|
41
41
|
},
|
|
42
42
|
"dependencies": {
|
|
43
43
|
"@a2a-js/sdk": "^0.3.10",
|
|
44
|
-
"@aixyz/cli": "0.
|
|
45
|
-
"@aixyz/config": "0.
|
|
46
|
-
"@aixyz/erc-8004": "0.
|
|
44
|
+
"@aixyz/cli": "0.36.0",
|
|
45
|
+
"@aixyz/config": "0.36.0",
|
|
46
|
+
"@aixyz/erc-8004": "0.36.0",
|
|
47
47
|
"@kitajs/html": "^4.2.13",
|
|
48
48
|
"@modelcontextprotocol/sdk": "^1.27.1",
|
|
49
49
|
"@next/env": "^16.1.6",
|