API reference
Canonical contracts: contracts/README.md. Base URLs from env (local or aimoassist.com).
Env
| Var | Who |
|---|---|
GATEWAY_URL / ENGINE_URL / CLIENT_URL | Cross-service |
VALIO_API_KEY / VALIO_API_BASE / VALIO_RECORD_MODE | Gateway |
GEMINI_API_KEY / DECISION_* / LLM_* / LLM_RECORD_MODE | Engine |
TELEGRAM_BOT_TOKEN / APPROVER_KEYS_DIR | Bot / client |
DEMO_MODE | Demo routes |
Signed objects
PermissionSlip · Offer · Approval · OrderConfirmation: Ed25519 JWS, RFC 8785. Auth: Authorization: Slip … + Agent-Signature.
Gateway
| Route | Auth |
|---|---|
GET /.well-known/agent-interface.json · jwks.json | none |
POST /v1/products/search · get · substitutes | none |
POST /v1/quotes · policy/check · orders | slip + agent |
GET /v1/orders · audit | slip |
POST /v1/slips/revoke | kitchen-signed |
MCP tools (same handlers): search_products, get_products, get_substitutes, request_quote, check_policy, place_order, get_order, list_orders, get_audit_trail, recipes.
Engine (client → engine only)
Kitchens, KB sections, requests (SSE), carts, submit, learn, assist (voice/photo), weekly.
Full walkthrough: Agent interface.