aixyz 0.32.0 → 0.33.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.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: "Deploying"
3
- description: "Deploy your agent to Vercel, standalone Bun, or Docker"
3
+ description: "Deploy your agent to Vercel, Railway, standalone Bun, or Docker"
4
4
  ---
5
5
 
6
6
  ## Vercel
@@ -33,7 +33,7 @@ Set `OPENAI_API_KEY` and any payment environment variables in the Vercel dashboa
33
33
 
34
34
  ## Standalone (Bun Runtime)
35
35
 
36
- For direct deployment on Bun-compatible hosts (DigitalOcean, Railway, Fly.io, etc.):
36
+ For direct deployment on Bun-compatible hosts (DigitalOcean, Fly.io, etc.):
37
37
 
38
38
  ```bash
39
39
  aixyz build
@@ -52,16 +52,58 @@ export OPENAI_API_KEY=sk-...
52
52
  bun .aixyz/output/server.js
53
53
  ```
54
54
 
55
+ ## Railway
56
+
57
+ [Railway](https://railway.com) auto-detects a `Dockerfile` in your project root. Use a multi-stage build so only the compiled output is shipped in the final image, and pass `RAILWAY_PUBLIC_DOMAIN` at build time so the agent URL is resolved automatically.
58
+
59
+ ```dockerfile title="Dockerfile"
60
+ FROM oven/bun:1 AS build
61
+ WORKDIR /app
62
+ COPY . .
63
+ RUN bun install
64
+ ARG RAILWAY_PUBLIC_DOMAIN
65
+ ENV RAILWAY_PUBLIC_DOMAIN=$RAILWAY_PUBLIC_DOMAIN
66
+ RUN bun run build
67
+
68
+ FROM oven/bun:1-slim
69
+ WORKDIR /app
70
+ COPY --from=build /app/.aixyz/output .aixyz/output
71
+ CMD ["bun", ".aixyz/output/server.js"]
72
+ ```
73
+
74
+ Deploy by connecting your GitHub repository to a Railway project. Railway injects `RAILWAY_PUBLIC_DOMAIN` automatically so `bun run build` picks up the correct public URL — no manual `url` config needed.
75
+
76
+ Set `OPENAI_API_KEY` and any payment environment variables in the Railway dashboard under **Variables**.
77
+
78
+ Add a `.dockerignore` to keep the build context small:
79
+
80
+ ```text title=".dockerignore"
81
+ node_modules
82
+ .aixyz
83
+ .vercel
84
+ .env*.local
85
+ *.log
86
+ ```
87
+
88
+ <Note>
89
+ `RAILWAY_PUBLIC_DOMAIN` is only available after a public domain is assigned in Railway. If you use a custom domain,
90
+ set it there first and Railway will expose it as the `RAILWAY_PUBLIC_DOMAIN` build argument.
91
+ </Note>
92
+
55
93
  ## Docker
56
94
 
57
- Using the standalone build:
95
+ For self-hosted or custom container deployments, use a multi-stage build to keep the final image small:
58
96
 
59
97
  ```dockerfile title="Dockerfile"
60
- FROM oven/bun:1.3.9
98
+ FROM oven/bun:1 AS build
61
99
  WORKDIR /app
62
100
  COPY . .
63
101
  RUN bun install
64
102
  RUN bun run build
103
+
104
+ FROM oven/bun:1-slim
105
+ WORKDIR /app
106
+ COPY --from=build /app/.aixyz/output .aixyz/output
65
107
  CMD ["bun", ".aixyz/output/server.js"]
66
108
  ```
67
109
 
@@ -75,6 +117,16 @@ docker run -p 3000:3000 \
75
117
  my-agent
76
118
  ```
77
119
 
120
+ Add a `.dockerignore` to keep the build context small:
121
+
122
+ ```text title=".dockerignore"
123
+ node_modules
124
+ .aixyz
125
+ .vercel
126
+ .env*.local
127
+ *.log
128
+ ```
129
+
78
130
  <Warning>Never bake API keys into Docker images. Pass them as environment variables at runtime.</Warning>
79
131
 
80
132
  <Note>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aixyz",
3
- "version": "0.32.0",
3
+ "version": "0.33.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.32.0",
44
- "@aixyz/config": "0.32.0",
45
- "@aixyz/erc-8004": "0.32.0",
43
+ "@aixyz/cli": "0.33.0",
44
+ "@aixyz/config": "0.33.0",
45
+ "@aixyz/erc-8004": "0.33.0",
46
46
  "@kitajs/html": "^4.2.13",
47
47
  "@modelcontextprotocol/sdk": "^1.27.1",
48
48
  "@next/env": "^16.1.6",