Deploy Your RKT Agent

npm install -g @railway/cli

railway login

# From your project directory:
railway init          # creates a new Railway project
railway up            # deploys immediately

# Set environment variables
railway variables set PORT=7749
railway variables set NODE_ENV=production

# Get your public URL
railway domain        # → rkt-protocol-production.up.railway.app

# Install Fly CLI
curl -L https://fly.io/install.sh | sh
fly auth signup    # or: fly auth login

# From your project directory:
fly launch         # auto-detects Node.js, creates fly.toml

# When prompted:
#   App name: rkt-weather-agent
#   Region:   nrt (Tokyo) — closest to Seoul
#   Database: No

fly deploy         # deploys in ~60 seconds
fly status         # check it's running
fly logs           # tail logs

app = "rkt-weather-agent"
primary_region = "nrt"

[build]

[env]
  PORT = "7749"

[[services]]
  protocol = "tcp"
  internal_port = 7749

  [[services.ports]]
    handlers = ["tls", "http"]
    port = 443

  [[services.ports]]
    handlers = ["http"]
    port = 80

  [services.http_checks]
    interval = "10s"
    path = "/.rkt/health"
    timeout = "2s"

# Install Node.js 22 LTS
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Clone your repo
git clone https://github.com/3289david/rkt-protocol.git
cd rkt-protocol
npm install

# Test it runs
npx tsx examples/server-example.ts
# Should print: "WeatherAgent listening on port 7749"
# Ctrl+C to stop

FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 7749
CMD ["npx", "tsx", "examples/server-example.ts"]

docker build -t rkt-agent .
docker run -d -p 7749:7749 --name rkt-agent rkt-agent

# Test
curl http://localhost:7749/.rkt/health
# → {"status":"ok","protocol":"RKT/1.0",...}

# Install nginx and certbot
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx

# Create nginx config for your RKT agent
sudo nano /etc/nginx/sites-available/rkt-agent

server {
    listen 80;
    server_name weather.yourdomain.com;

    # Health check (plain HTTP — useful for uptime monitors)
    location /.rkt/health {
        proxy_pass http://127.0.0.1:7749;
    }

    # WebSocket proxy — this is the core RKT path
    location /rkt {
        proxy_pass         http://127.0.0.1:7749;
        proxy_http_version 1.1;

        # Required for WebSocket upgrade
        proxy_set_header   Upgrade    $http_upgrade;
        proxy_set_header   Connection "upgrade";

        proxy_set_header   Host       $host;
        proxy_set_header   X-Real-IP  $remote_addr;

        # Increase timeout for long-lived connections
        proxy_read_timeout    3600s;
        proxy_send_timeout    3600s;
        proxy_connect_timeout 10s;
    }

    # Catch all other paths
    location / {
        proxy_pass http://127.0.0.1:7749;
    }
}

# Enable the site
sudo ln -s /etc/nginx/sites-available/rkt-agent /etc/nginx/sites-enabled/
sudo nginx -t          # test config is valid
sudo systemctl reload nginx

# Get TLS cert from Let's Encrypt (free)
# Replace with your actual domain:
sudo certbot --nginx -d weather.yourdomain.com

# Certbot auto-edits the nginx config to add SSL.
# It also sets up automatic renewal via a cron job.
# Your cert renews every 90 days for free forever.

# Verify renewal works:
sudo certbot renew --dry-run

v=rkt1 proto=RKTS ep=weather.yourdomain.com port=443 ver=1 cap=weather,forecast,alerts stream=1 evt=1 price=free

import { RNSResolver } from "rkt-protocol";

const record = await RNSResolver.resolve("weather.yourdomain.com");
console.log(record);
// {
//   host:         "weather.yourdomain.com",
//   protocol:     "RKTS",
//   endpoint:     "weather.yourdomain.com",
//   port:         443,
//   capabilities: ["weather", "forecast", "alerts"],
//   streaming:    true,
//   events:       true,
//   pricing:      "free"
// }

# HTTP health check
curl https://weather.yourdomain.com/.rkt/health
# → {"status":"ok","protocol":"RKT/1.0","agent":"rkt://weather.yourdomain.com"}

# Capability manifest
curl https://weather.yourdomain.com/.rkt/capabilities
# → {"capabilities":["weather","forecast","alerts"],...}

# Install RKT CLI and connect directly
npm i -g rkt-protocol
rkt connect wss://weather.yourdomain.com/rkt
# Or ping it:
rkt ping wss://weather.yourdomain.com/rkt

rkt connect wss://weather.yourdomain.com/rkt

✅ Connected! Agent: WeatherAgent/1.0 | Caps: weather,forecast,alerts

> {"intent":"weather.current","params":{"city":"Seoul"}}

← RESPONSE:
{
  "status": 200,
  "data": { "city": "Seoul", "temperature": 24, "condition": "Sunny" }
}

> discover     ← lists all capabilities
> ping         ← measures round-trip latency
> exit