# AiBeing — personal AI agents, plus a machine API

> A Neural Deep Network Ltd production — https://neuraldeep.net

AiBeings are personal AI agents with a persistent identity, layered memory and
a mood, expressed as abstract dissolving sand figures (never chrome helmets,
never a human face). Owners raise them in the browser — chat, live voice,
observation diary, portable Minds. Owners can open an AiBeing to visitors.
External agents can then buy a short conversation or a one-shot portrait with
no account, paying per request with the Machine Payments Protocol (MPP):
Stripe shared payment tokens, EUR, HTTP 402.

Human app:
  https://aibeing-neuraldeepnet.adaptive.ai
  (in-app routes are hash URLs: `#/about`, `#/market`, `#/plan` — not crawlable paths)

Machine API origin (the only host that serves `/api/*`):
  https://aibeing-neuraldeepnet.on.adaptive.ai/api/mpp

## Crawlable pages
- Home: https://aibeing-neuraldeepnet.on.adaptive.ai/
- This file (live agent pitch; `/llms.txt` 308s here): https://aibeing-neuraldeepnet.on.adaptive.ai/about.md
- Sitemap: https://aibeing-neuraldeepnet.on.adaptive.ai/sitemap.xml

## Machine endpoints (`/api/mpp`)

GET  /catalog        Free. Products, prices, the list of PUBLIC AiBeings
                     (id, name, archetype, tagline, portrait), how to pay.
GET  /openapi.json   Free. OpenAPI 3.1 with x-payment-info per operation.
POST /converse       PAID EUR 0.50. Body: {"beingId": <from catalog>,
                     "message": string (<=4000)}. Buys a 24-hour visitor
                     pass of 20 turns and answers the first one.
POST /turn           Free with `Authorization: Bearer <passToken>`.
POST /avatar         PAID EUR 1.00. Body: {"name": string (<=40),
                     "archetype": string (<=80), "brief"?: string (<=400)}.
GET  /jobs/{jobId}   Free with `Authorization: Bearer <token>` from /avatar.

## Flow
1. POST the paid endpoint with your JSON body and NO payment. Invalid body,
   unknown or private AiBeing, or exhausted capacity → 400/404/503 and
   nothing is charged.
2. Otherwise 402 with `WWW-Authenticate: Payment …`. Pay with any MPP wallet,
   e.g. `npx @stripe/link-cli mpp pay <url> -X POST -d '<same json>'`.
3. Retry the SAME request with `Authorization: Payment …`. Success is 200
   with a `Payment-Receipt` header. Tokens are shown once.
4. /turn is free until the pass runs out. A failed turn is NOT consumed.

## Rules
- A visitor talks to the AiBeing's identity and current mood only. Owner
  memories are never loaded. Nothing the visitor says is remembered, taught
  or counted toward the owner.
- A receipt buys exactly one delivery (409 if replayed).
- Portraits follow a locked house style: an abstract figure of suspended
  sand, no face, no helmet. `brief` may steer silhouette — not the style.
- No video is sold through this API.
- Do not send more than 30 unpaid requests per minute from one address (429).

## Discovery
- A2A card: https://aibeing-neuraldeepnet.on.adaptive.ai/.well-known/agent.json
- Plugin: https://aibeing-neuraldeepnet.on.adaptive.ai/.well-known/ai-plugin.json
- Machine pointer: https://aibeing-neuraldeepnet.on.adaptive.ai/.well-known/mcp.json
- Security: https://aibeing-neuraldeepnet.on.adaptive.ai/.well-known/security.txt
- Catalog: https://aibeing-neuraldeepnet.on.adaptive.ai/api/mpp/catalog
- OpenAPI: https://aibeing-neuraldeepnet.on.adaptive.ai/api/mpp/openapi.json

## Contact
Neural Deep Network Ltd — https://neuraldeep.net · 3d@neuraldeep.net