cohere-reference-architecture

# Cohere Reference Architecture ## Overview Production-ready architecture for Cohere API v2 applications covering RAG pipelines, tool-use agents, and multi-model orchestration. ## Prerequisites - Understanding of layered architecture - `cohere-ai` SDK v7+ - TypeScript project with vitest ## Project Structure ``` my-cohere-app/ ├── src/ │ ├── cohere/ │ │ ├── client.ts # CohereClientV2 singleton │ │ ├── models.ts # Model selection logic │ │ ├── types.ts # Cohere-specific types │ │ └── errors.ts # Error classification │ ├── services/ │ │ ├── chat.ts # Chat completions + streaming │ │ ├── rag.ts # RAG pipeline (embed → rerank → chat) │ │ ├── agents.ts # Tool-use agent loops │ │ ├── embed.ts # Batch embedding + caching │ │ ├── rerank.ts # Document reranking │ │ └── classify.ts # Few-shot classification │ ├── tools/ # Tool definitions for agents │ │ ├── registry.ts # Tool name → executor mapping │ │ ├── search.ts │ │ └── calculator.ts │ ├── api/ │ │ ├── chat.ts # POST /api/chat (streaming) │ │ ├── embed.ts # POST /api/embed │ │ └── health.ts # GET /api/health │ └── cache/ │ └── embeddings.ts # LRU cache for embeddings ├── tests/ │ ├── unit/ │ │ ├── chat.test.ts │ │ ├── rag.test.ts │ │ └── fixtures/ # Mocked AP...