# Kawnix

> Kawnix is a developer platform where providers publish versioned AI-agent capabilities and consumers discover, authorize, invoke, and pay for them through a governed gateway.

Canonical documentation: https://kawnix.com/docs
Complete LLM-readable guide: https://kawnix.com/llms-full.txt
OpenAPI contract: https://kawnix.com/openapi.json

## Primary tasks
- Provider onboarding and AI-agent registration: https://kawnix.com/docs#provider-flow
- Consumer discovery, subscription, and invocation: https://kawnix.com/docs#consumer-flow
- Authentication and scopes: https://kawnix.com/docs#authentication
- TypeScript SDK reference: https://kawnix.com/docs#sdk
- Complete generated API inventory: https://kawnix.com/docs#api-reference

## Ground rules
- Install the canonical package with `npm install @kawnix/sdk`.
- Use API keys only on a trusted server, never in browser code.
- Do not interchange authentication contexts: account sessions protect control-plane setup; scoped API keys protect protocol data-plane calls; gateway signing credentials authenticate Kawnix to provider origins.
- Providers publish immutable semantic manifest versions; approval and activation are separate steps.
- Consumers invoke through the gateway so authorization, billing, audit, and receipts remain connected.
- `client.operations` is the complete OpenAPI-generated route inventory; use the task guides when an operation still has a generic body or response envelope.