# antony-collika/tov architecture

> Architecture diagram of the GitHub repository antony-collika/tov, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antony-collika/tov
- Repository: https://github.com/antony-collika/tov

## Overview

ByokChat is an Android chat app for using user-configured AI providers. The apparent main workflow is user input through the chat UI, generation through chat orchestration and a selected provider, then display and persistence of the conversation. The tree also shows tool execution, provider/configuration management, history operations, and request inspection. Only build files were excerpted and the README is empty, so these connections are inferred from names and are shown as unverified; implementation details and exact call ownership could not be confirmed.

Main entry points: [`app/src/main/java/com/example/byokchat/chat/ChatEngine.kt`](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/ChatEngine.kt) (Chat engine), [`app/src/main/java/com/example/byokchat/chat/GenerationService.kt`](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/GenerationService.kt) (Generation service), [`app/src/main/java/com/example/byokchat/ai/ProviderFactory.kt`](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/ProviderFactory.kt) (Provider selection), [`app/src/main/java/com/example/byokchat/data/ConversationRepository.kt`](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/data/ConversationRepository.kt) (Conversation repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Chat experience"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_chatui["Chat UI<br/>[ChatScreen.kt]"]
  node_viewmodel["Chat view model<br/>[ChatViewModel.kt]"]
  node_historyui["Conversation browsing"]
  node_settingsui["Provider settings<br/>[ProvidersScreen.kt]"]
  node_inspection["Request inspection"]
end

subgraph group_runtime["Chat runtime"]
  node_engine["Chat engine<br/>[ChatEngine.kt]"]
  node_generation["Generation service"]
  node_assembler["Request assembly"]
  node_context["Context building<br/>[ContextBuilder.kt]"]
  node_toolruntime["Tool runtime<br/>[ToolRuntime.kt]"]
  node_registry["Tool registry<br/>[ToolRegistry.kt]"]
  node_workspace["Workspace tools<br/>[WorkspaceFs.kt]"]
end

subgraph group_providers["AI providers"]
  node_factory["Provider selection<br/>[ProviderFactory.kt]"]
  node_openai["OpenAI provider<br/>[OpenAiProvider.kt]"]
  node_responses["Responses provider"]
  node_gemini["Gemini provider<br/>[GeminiProvider.kt]"]
end

subgraph group_state["App state"]
  node_repository["Conversation repository"]
  node_database[("App database<br/>[AppDatabase.kt]")]
  node_settings["Settings repository"]
  node_requestlog["Request log<br/>[RequestLog.kt]"]
  node_history["History sync/export<br/>[HistorySync.kt]"]
end

node_user(("User"))
node_remote{{"AI service"}}

node_user -.->|"opens app"| node_activity
node_activity -.->|"shows chat"| node_chatui
node_chatui -.->|"submits input"| node_viewmodel
node_viewmodel -.->|"starts turn"| node_engine
node_engine -.->|"builds context"| node_context
node_engine -.->|"requests generation"| node_generation
node_generation -.->|"assembles request"| node_assembler
node_generation -.->|"selects provider"| node_factory
node_factory -.->|"selects provider"| node_openai
node_factory -.->|"selects provider"| node_responses
node_factory -.->|"selects provider"| node_gemini
node_openai -.->|"sends request"| node_remote
node_responses -.->|"sends request"| node_remote
node_gemini -.->|"sends request"| node_remote
node_engine -.->|"runs tools"| node_toolruntime
node_toolruntime -.->|"dispatches tools"| node_registry
node_registry -.->|"offers tools"| node_workspace
node_viewmodel -.->|"loads and saves"| node_repository
node_repository -.->|"persists conversations"| node_database
node_historyui -.->|"browses conversations"| node_repository
node_settingsui -.->|"configures providers"| node_settings
node_generation -.->|"records requests"| node_requestlog
node_inspection -.->|"views requests"| node_requestlog
node_history -.->|"syncs history"| node_repository

click node_activity "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/MainActivity.kt"
click node_chatui "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/ChatScreen.kt"
click node_viewmodel "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/ChatViewModel.kt"
click node_historyui "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/ConversationDrawer.kt"
click node_settingsui "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/ProvidersScreen.kt"
click node_inspection "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/RequestInspectorScreen.kt"
click node_engine "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/ChatEngine.kt"
click node_generation "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/GenerationService.kt"
click node_assembler "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/RequestAssembler.kt"
click node_context "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/ContextBuilder.kt"
click node_toolruntime "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/ToolRuntime.kt"
click node_registry "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/tools/ToolRegistry.kt"
click node_workspace "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/tools/WorkspaceFs.kt"
click node_factory "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/ProviderFactory.kt"
click node_openai "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/OpenAiProvider.kt"
click node_responses "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/ResponsesProvider.kt"
click node_gemini "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/GeminiProvider.kt"
click node_repository "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/data/ConversationRepository.kt"
click node_database "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/data/AppDatabase.kt"
click node_settings "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/data/SettingsRepository.kt"
click node_requestlog "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/RequestLog.kt"
click node_history "https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/HistorySync.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity,node_chatui,node_viewmodel,node_historyui,node_settingsui,node_inspection,node_user toneBlue
class node_engine,node_generation,node_assembler,node_context,node_toolruntime,node_registry,node_workspace toneAmber
class node_factory,node_openai,node_responses,node_gemini toneMint
class node_repository,node_database,node_settings,node_requestlog,node_history toneRose
class node_remote toneIndigo
```

## Components

### Chat experience

- [Main activity](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/MainActivity.kt): `app/src/main/java/com/example/byokchat/MainActivity.kt`
- [Chat UI](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/ChatScreen.kt): `app/src/main/java/com/example/byokchat/ui/ChatScreen.kt`
- [Chat view model](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/ChatViewModel.kt): `app/src/main/java/com/example/byokchat/ui/ChatViewModel.kt`
- [Conversation browsing](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/ConversationDrawer.kt): `app/src/main/java/com/example/byokchat/ui/ConversationDrawer.kt`
- [Provider settings](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/ProvidersScreen.kt): `app/src/main/java/com/example/byokchat/ui/ProvidersScreen.kt`
- [Request inspection](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ui/RequestInspectorScreen.kt): `app/src/main/java/com/example/byokchat/ui/RequestInspectorScreen.kt`

### Chat runtime

- [Chat engine](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/ChatEngine.kt): `app/src/main/java/com/example/byokchat/chat/ChatEngine.kt`
- [Generation service](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/GenerationService.kt): `app/src/main/java/com/example/byokchat/chat/GenerationService.kt`
- [Request assembly](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/RequestAssembler.kt): `app/src/main/java/com/example/byokchat/chat/RequestAssembler.kt`
- [Context building](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/ContextBuilder.kt): `app/src/main/java/com/example/byokchat/chat/ContextBuilder.kt`
- [Tool runtime](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/ToolRuntime.kt): `app/src/main/java/com/example/byokchat/chat/ToolRuntime.kt`
- [Tool registry](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/tools/ToolRegistry.kt): `app/src/main/java/com/example/byokchat/tools/ToolRegistry.kt`
- [Workspace tools](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/tools/WorkspaceFs.kt): `app/src/main/java/com/example/byokchat/tools/WorkspaceFs.kt`

### AI providers

- [Provider selection](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/ProviderFactory.kt): `app/src/main/java/com/example/byokchat/ai/ProviderFactory.kt`
- [OpenAI provider](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/OpenAiProvider.kt): `app/src/main/java/com/example/byokchat/ai/OpenAiProvider.kt`
- [Responses provider](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/ResponsesProvider.kt): `app/src/main/java/com/example/byokchat/ai/ResponsesProvider.kt`
- [Gemini provider](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/GeminiProvider.kt): `app/src/main/java/com/example/byokchat/ai/GeminiProvider.kt`

### App state

- [Conversation repository](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/data/ConversationRepository.kt): `app/src/main/java/com/example/byokchat/data/ConversationRepository.kt`
- [App database](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/data/AppDatabase.kt): `app/src/main/java/com/example/byokchat/data/AppDatabase.kt`
- [Settings repository](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/data/SettingsRepository.kt): `app/src/main/java/com/example/byokchat/data/SettingsRepository.kt`
- [Request log](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/ai/RequestLog.kt): `app/src/main/java/com/example/byokchat/ai/RequestLog.kt`
- [History sync/export](https://github.com/antony-collika/tov/blob/main/app/src/main/java/com/example/byokchat/chat/HistorySync.kt): `app/src/main/java/com/example/byokchat/chat/HistorySync.kt`

### Other components

- **User**
- **AI service**

## Connections

- User → Main activity: opens app
- Main activity → Chat UI: shows chat
- Chat UI → Chat view model: submits input
- Chat view model → Chat engine: starts turn
- Chat engine → Context building: builds context
- Chat engine → Generation service: requests generation
- Generation service → Request assembly: assembles request
- Generation service → Provider selection: selects provider
- Provider selection → OpenAI provider: selects provider
- Provider selection → Responses provider: selects provider
- Provider selection → Gemini provider: selects provider
- OpenAI provider → AI service: sends request
- Responses provider → AI service: sends request
- Gemini provider → AI service: sends request
- Chat engine → Tool runtime: runs tools
- Tool runtime → Tool registry: dispatches tools
- Tool registry → Workspace tools: offers tools
- Chat view model → Conversation repository: loads and saves
- Conversation repository → App database: persists conversations
- Conversation browsing → Conversation repository: browses conversations
- Provider settings → Settings repository: configures providers
- Generation service → Request log: records requests
- Request inspection → Request log: views requests
- History sync/export → Conversation repository: syncs history
