Developer guide
These pages explain how Kontext is put together and how to work in this
repository. They assume a checkout and the toolchains described in the
AGENTS.md.
AI architecture
Section titled “AI architecture”- AI architecture — Agents, teams, tools, and the SQL validation path behind Kontext’s AI features.
- Agent harness abstraction — How the agent framework stays a swappable adapter behind neutral contracts.
- Model provider configuration — Provider inputs, catalog defaults, and the harness-neutral model object.
- Tool result schemas — The shared transport schema for tool results across TypeScript and Python.
Notebook
Section titled “Notebook”- Notebook system — The block document model, package layout, and host integration contract.
Repository workflows
Section titled “Repository workflows”- Generated code — The committed API types and Python models, and how to regenerate them.
- OpenAPI workflow — Refreshing and validating the tracked API specifications.
- Python package boundaries — The Python package responsibility matrix and dependency rules.
- Releasing — The app, wheel, TypeScript package, and docs publishing paths.