Developer Docs

Developer Docs

This section documents the current runtime behavior across all active repositories:

• kobi-ai (Next.js UI + BFF APIs)
• kobi-agent-service (FastAPI + LangGraph engine)
• kobi-mcp-server (MCP tool and resource server)
• kobi-web (documentation site)

Current Principles

• Chat inference always goes through BFF routes (/api/ai/*), never directly from browser to engine.
• BFF performs auth, scope checks, payload normalization, and service-to-service engine headers.
• Engine owns orchestration, HITL interrupts, and MCP dispatch.
• MCP owns tool-level auth/gating/idempotency for tool side effects.
• Canvas read/write APIs are BFF-owned, while some tool writes are persisted through MCP service handlers.

Main Topics

Overview

• Developer Overview

Architecture

• Architecture Home
• Cross-System Status
• System Overview
• Repository and Codebase Map
• Data Models and Ownership
• Thread and State Lifecycle
• Ownership Boundary
• Runtime Flow Diagrams
• MCP Execution Model

Integration Contracts

• API and Event Contracts
• Hybrid Canvas API Calls

Security and Governance

• Identity, Access, and Data Isolation
• Architecture Guardrails

Operations

• Operations Runbook