# hello-world

A minimal m64 capsule: an OpenAI-compatible chat endpoint that answers
`Hello, world! You said: <your last message>`. No model, no GPU, no network. It
exists to show what every capsule looks like from the outside.

Base URL: `{{BASE_URL}}`

## Routes

| Method | Path | Served by | What |
| --- | --- | --- | --- |
| POST | `/v1/chat/completions` | the capsule | the greeting, streaming or not |
| GET | `/v1/models` | the capsule | one model: `hello-world` |
| GET | `/status` | m64 | phase (`ready` when usable) |
| GET | `/agent` | m64 | this document, with the base URL filled in |
| GET | `/human/` | m64 | a page for people, with a form to try it |

Any other path is a 404: m64's front only lets a `chat` capsule's routes through.

### POST /v1/chat/completions

```sh
curl -s {{BASE_URL}}/v1/chat/completions {{AUTH}} \
  -H 'Content-Type: application/json' \
  -d '{"messages":[{"role":"user","content":"hi there"}]}'
```

Accepted fields: `messages` (required), `tools`, `tool_choice`,
`response_format`, `max_tokens`, `stream`, `seed`. Anything else, like
`temperature`, is refused by m64 with a 400 that names the field. `model` is
rewritten to `hello-world` whatever you send.

`"stream": true` returns server-sent events, one word per chunk, ending with
`data: [DONE]`.

### GET /status

```sh
curl -s {{BASE_URL}}/status {{AUTH}}
```

## Timings and limits

- Ready about a second after start.
- Every answer is instant. Requests are handled in parallel.
- Errors: 400 for a body without a `messages` list, 404 for an unknown path.