Verify Installation

Check server health

# Liveness — is the process running?
curl http://localhost:3010/health

# Readiness — is everything initialized?
curl http://localhost:3010/ready

Expected /ready response:

{
  "status": "ready",
  "checks": {
    "database": "ok",
    "migrations": "ok",
    "widget": "ok",
    "sdk": { "connected": true, "functions": 6 }
  }
}

Confirm SDK connection

When your backend starts with AELIO_SDK_SECRET set, you should see:

Aelio SDK connected to ws://127.0.0.1:3010

Verify registered functions (test mode only):

curl http://localhost:3010/__test__/sdk/functions
# ["getOrderStatus", "cancelOrder", "listOrders", ...]

Open the chat widget in your browser. The status indicator should transition:

Connecting → Connected

Send a test message and verify you get an LLM-powered reply — not an error message.

Run the end-to-end smoke test

From the Shopping Testbed:

npm run smoke

This tests: health endpoint, product listing, session creation, cart operations, and checkout.

Run the automated test suite

AELIO_TEST_MODE=1 pnpm test:all

Runs phase tests against the server + SDK integration.

Checklist

Everything working?

Server /health returns ok
Server /ready shows all checks green
SDK connected (visible in /ready or startup logs)
Widget shows "Connected" status
Test message gets LLM reply (not error)
Write action shows confirmation prompt
Tool invocation logged in SDK console

Troubleshooting

See Error Handling guide for detailed troubleshooting of connection, auth, and tool errors.