aixyz 0.30.0 → 0.31.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.
@@ -23,7 +23,7 @@ An aixyz agent is defined by a small set of files in a standard layout. Run `aix
23
23
  {
24
24
  name: "app/",
25
25
  children: [
26
- { name: "agent.ts", description: "Main agent definition", badge: { text: "required", color: "green" } },
26
+ { name: "agent.ts", description: "Main agent definition" },
27
27
  { name: "agent.test.ts", description: "Agent tests" },
28
28
  {
29
29
  name: "server.ts",
@@ -121,7 +121,7 @@ An aixyz agent is defined by a small set of files in a standard layout. Run `aix
121
121
  | File | Required | Description |
122
122
  | ------------------- | -------- | --------------------------------------------------------------------------------- |
123
123
  | `aixyz.config.ts` | Yes | [Agent metadata, payment config, and skills](/config/aixyz-config) |
124
- | `app/agent.ts` | Yes\* | Agent definition using Vercel AI SDK |
124
+ | `app/agent.ts` | No\* | Agent definition using Vercel AI SDK |
125
125
  | `app/agents/*.ts` | No | Sub-agent definitions, each gets its own endpoint |
126
126
  | `app/tools/*.ts` | No | Tool implementations, auto-discovered by the build |
127
127
  | `app/server.ts` | No | [Custom server](/api-reference/aixyz-server) — overrides auto-generation entirely |
@@ -131,17 +131,17 @@ An aixyz agent is defined by a small set of files in a standard layout. Run `aix
131
131
  | `app/icon.svg` | No | Agent icon served as a static asset |
132
132
  | `vercel.json` | No | Vercel deployment configuration |
133
133
 
134
- \* Required if no `app/server.ts` is provided.
134
+ \* If omitted, the build skips A2A endpoints and only serves tools via MCP. Required if no `app/server.ts` is provided and you need A2A.
135
135
 
136
136
  ## How It Works
137
137
 
138
138
  The build pipeline scans the `app/` directory to auto-generate a server:
139
139
 
140
140
  1. Reads `aixyz.config.ts` for agent metadata and skills
141
- 2. Imports `app/agent.ts` for the main agent definition
141
+ 2. Imports `app/agent.ts` for the main agent definition (if present)
142
142
  3. Discovers all `.ts` files in `app/agents/` for sub-agents (each gets its own A2A endpoint)
143
143
  4. Discovers all `.ts` files in `app/tools/` (excluding `_` prefixed files)
144
- 5. Wires up A2A, MCP, and x402 endpoints automatically
144
+ 5. Wires up A2A (when agents exist), MCP (when tools exist), and x402 endpoints automatically
145
145
 
146
146
  The result is a server exposing:
147
147
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aixyz",
3
- "version": "0.30.0",
3
+ "version": "0.31.0",
4
4
  "description": "Payment-native SDK for AI Agent",
5
5
  "keywords": [
6
6
  "ai",
@@ -40,9 +40,9 @@
40
40
  },
41
41
  "dependencies": {
42
42
  "@a2a-js/sdk": "^0.3.10",
43
- "@aixyz/cli": "0.30.0",
44
- "@aixyz/config": "0.30.0",
45
- "@aixyz/erc-8004": "0.30.0",
43
+ "@aixyz/cli": "0.31.0",
44
+ "@aixyz/config": "0.31.0",
45
+ "@aixyz/erc-8004": "0.31.0",
46
46
  "@kitajs/html": "^4.2.13",
47
47
  "@modelcontextprotocol/sdk": "^1.27.1",
48
48
  "@next/env": "^16.1.6",