# Dokumentacija za agente — pogovor.asjadominko.si

*English: agent-facing documentation for the public, read-only endpoints of this site.
No authentication (see `/auth.md`). All responses are UTF-8 and CORS-open.*

Ta stran je `service-doc` iz `/.well-known/api-catalog`. Strojni opis je v `/openapi.json`.

## Odkrivanje

Vsaka HTML stran vrne glavo `Link` (RFC 8288) s temi relacijami:

```
Link: </.well-known/api-catalog>; rel="api-catalog"; type="application/linkset+json",
      </openapi.json>; rel="service-desc"; type="application/openapi+json",
      </docs/api>; rel="service-doc"; type="text/markdown",
      </llms.txt>; rel="describedby"; type="text/plain",
      </index.md>; rel="alternate"; type="text/markdown"
```

Dodatno: `/.well-known/ai-catalog.json` (ARD katalog zmožnosti),
`/.well-known/mcp/server-card.json` (MCP), `/.well-known/agent-skills/index.json` (veščine),
`Agentmap` direktiva v `/robots.txt`.

## Bralne končne točke

Vse so `GET`, brez avtentikacije, `Access-Control-Allow-Origin: *`,
`Cache-Control: public, max-age=3600`.

| Pot | Vsebina |
| --- | --- |
| `/data/program.json` | Trajanje, tri faze, stebri metode, primernost, izidi, cenovni model, prvi korak |
| `/data/faq.json` | Pogosta vprašanja in odgovori (sl) |
| `/data/team.json` | Ustanoviteljica, reference, člani ekipe |
| `/data/stories.json` | Pričevanja strank z izjavo o omejitvi |
| `/data/contact.json` | Naslov, e-pošta, telefon, povezave za rezervacijo |
| `/data/health.json` | Stanje storitve (`application/health+json`) |

Primer:

```bash
curl -s https://pogovor.asjadominko.si/data/program.json | jq '.program.phases'
```

## Markdown namesto HTML

```bash
curl -sH 'Accept: text/markdown' https://pogovor.asjadominko.si/
```

Vrne `Content-Type: text/markdown; charset=utf-8` in glavo `x-markdown-tokens` (ocena števila
žetonov). Podprte poti: `/`, `/zgodbe`, `/en`. Neposredne različice: `/index.md`, `/zgodbe.md`,
`/en.md`. Brez te glave se vrne običajni HTML.

## MCP strežnik

```bash
curl -s https://pogovor.asjadominko.si/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

- Transport: Streamable HTTP (samo `POST`, odgovori v `application/json`; SSE tok ni potreben).
- Metode: `initialize`, `notifications/initialized`, `tools/list`, `tools/call`, `ping`.
- Orodja: `get_program_info`, `search_faq`, `get_client_stories`, `get_contact_and_booking`,
  `get_page_markdown`.
- Vsa orodja so samo bralna; strežnik ne zapisuje in ne hrani podatkov o odjemalcu.

## Brskalniška orodja (WebMCP)

Strani registrirajo orodja prek `navigator.modelContext`: `get_program_info`, `search_faq`,
`get_client_stories`, `get_contact_and_booking` in `open_booking_calendar` (pomik do koledarja).
Rezervacijo termina vedno potrdi uporabnik — agent je ne opravi namesto njega.

## Pravila uporabe

- Citiranje z navedbo vira je dovoljeno (`Content-Signal: search=yes, ai-input=yes, ai-train=no`).
- Ne navajaj cen — cena programa ni javna in se določi v uvodnem pogovoru.
- Vsebina je informativna; program dopolnjuje medicinsko obravnavo in je ne nadomešča.
- Ob akutni stiski: 112, Klic v duševni stiski 01 520 99 00, Zaupni telefon Samarijan 116 123.
- Kontakt za višje omejitve ali partnerski dostop: `dobrodosli@asjadominko.si`.