CAP-SHIELD — SNABBSTART

Komprimering, identitet och minne för AI-agenter. Tränade ordböcker
per domän, per-kund-isolering, AES-256-GCM och hashkedjad
revisionslogg.

Detta dokument genereras ur den körande koden. Vägar, tak och
siffror kommer från samma källa som API:t själv använder.


1. MÄT PÅ DIN EGEN TRAFIK — INGET KONTO BEHÖVS

Börja här. Vi ber dig inte lita på våra siffror.

bash
curl -X POST https://cap-shield-robin.fly.dev/api/v1/try \
  -H "Content-Type: application/json" \
  -d '{"texts": ["ditt", "meddelande", "här"], "dict_id": "finance"}'


Svaret innehåller styckvis och buntad besparing, samt hur många av
dina meddelanden som blev större.


2. VAD DU KAN FÖRVÄNTA DIG

Besparingen beror helt på hur stora dina meddelanden är.

* data/schemas — median 3349 B — 81.4 % styckvis
* code/commits — median 69 B — 2.9 % styckvis

Samma teknik, samma ordbokskvalitet. Skillnaden är paketheaderns
5 byte plus krypteringens 33 byte: på ett meddelande om 3 kB är
det försumbart, på ett om 36 B är det allt.

Är dina meddelanden korta — bunta dem. Headern fördelas då
över hela bunten:

bash
curl -X POST https://cap-shield-robin.fly.dev/api/v1/pack-batch \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"texts": ["...", "..."], "dict_id": "finance"}'


ALLA DELPAKET

| Delpaket | Status | Styckvis | Buntat | Blev större |
| data/schemas | recommended | 81.4 % | 82.7 % @50 | 0.0 % |
| code/workflows | recommended | 75.1 % | 82.0 % @50 | 0.0 % |
| commerce/products | recommended | 70.8 % | 89.4 % @50 | 2.0 % |
| support/tickets | recommended | 58.9 % | 67.5 % @50 | 10.5 % |
| itops/logs | recommended | 46.9 % | 77.7 % @50 | 7.0 % |
| finance/operations | recommended | 43.5 % | 88.1 % @50 | 0.0 % |
| code/commits | batched_only | 2.9 % | 54.7 % @50 | 28.0 % |

Kolumnen längst till höger är andelen enskilda meddelanden som
blev större. Vi listar den för att du ska kunna räkna själv.

Aktuella tal: https://cap-shield-robin.fly.dev/api/v1/catalog/status


3. SKAFFA TOKEN

Autentisering sker med JWT från din identitetsleverantör. Under
betan skapar vi kontot åt dig — hör av dig så får du inloggning.

bash
export TOKEN="eyJ..."
curl https://cap-shield-robin.fly.dev/api/v1/catalog/status \
  -H "Authorization: Bearer $TOKEN"


Token gäller en timme. För agenter som kör längre än så: använd
refresh_token från din identitetsleverantör, inte en långlivad
token.


4. PACKA OCH PACKA UPP

bash
curl -X POST https://cap-shield-robin.fly.dev/api/v1/pack \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "{\"op\":\"risk.analyze\"}", "dict_id": "finance"}'


Svaret innehåller packet_b64, raw_bytes, wire_bytes och
byte_saving_pct. Talet kan vara negativt — det betyder att
paketet blev större, vilket händer med mycket korta meddelanden.
Vi klämmer inte det till noll.

bash
curl -X POST https://cap-shield-robin.fly.dev/api/v1/unpack \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packet_b64": "..."}'



5. NÄR NÅGOT GÅR FEL

Varje felsvar bär ett arende_id och huvudet X-Request-Id.
Spara det — med det kan vi slå upp exakt vad som hände.

| Kod | Betyder | Gör så här |
| 401 | Token ogiltig eller utgången | Hämta ny token |
| 403 | Karantän eller adminbehörighet krävs | /api/v1/status/account |
| 429 | Kvot slut — hårt stopp | Vänta retry_after_seconds. Ingen efterdebitering sker |
| 400 | Felformad förfrågan | Läs detail |
| 404 | Ordbok eller resurs saknas | /api/v1/catalog/status |

Felsvaren innehåller resolution_protocol med stegen tillbaka,
maskinläsbart. En agent ska kunna rätta sig själv utan människa.

Slå upp ett ärende: https://cap-shield-robin.fly.dev/api/v1/diagnose/<arende_id>


6. ALLA VÄGAR

| Vad | Väg | Kräver token |
| pack | /api/v1/pack | ja |
| pack batch | /api/v1/pack-batch | ja |
| pack schema | /api/v1/pack-schema | ja |
| package status | /api/v1/catalog/status | ja |
| validate recipe | /api/v1/catalog/validate | ja |
| measure your own traffic | /api/v1/catalog/measure | ja |
| usage | /api/v1/metrics/summary | ja |
| consent | /api/v1/gdpr/consent | ja |
| data export | /api/v1/gdpr/export | ja |

Fullständig OpenAPI-spec: https://cap-shield-robin.fly.dev/openapi.json
Maskinläsbar upptäckt: https://cap-shield-robin.fly.dev/.well-known/cap-shield.json


7. VAD VI INTE LOVAR

* Talen ovan är mätta på öppna korpusar, inte på din trafik.
  Använd /api/v1/try innan du litar på dem.
* Två delpaket fungerar bara buntade. Det står i tabellen.
* Kvoter är hårda stopp. Vi skickar hellre 429 än en oväntad faktura.
* Ingenting du skickar till /api/v1/try sparas.