# sorsama/deepseek-harness-mobile architecture

> Architecture diagram of the GitHub repository sorsama/deepseek-harness-mobile, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sorsama/deepseek-harness-mobile
- Repository: https://github.com/sorsama/deepseek-harness-mobile

## Overview

DSH Mobile is an Android companion for remotely operating DeepSeek Harness. The main workflow is to discover or enter a host, establish a local or relay connection, select a session, then follow streamed conversation and use the chat UI to send prompts or act on approvals, questions, goals, and other harness features. Session state feeds chat, workspace, and trajectory views; notifications surface completion or pending action. The README documents several capabilities whose detailed wiring was not sampled, so those links are shown as documented rather than inferred from module names.

Main entry points: [`app/src/main/java/com/labteto/dshmobile/ui/screens/main/ChatScreen.kt`](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/ChatScreen.kt) (Chat and session views), [`app/src/main/java/com/labteto/dshmobile/data/SessionStore.kt`](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/data/SessionStore.kt) (Session state), [`app/src/main/java/com/labteto/dshmobile/connection/ConnectionManager.kt`](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/ConnectionManager.kt) (Connection manager), [`app/src/main/java/com/labteto/dshmobile/connection/HarnessClientFactory.kt`](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/HarnessClientFactory.kt) (Client factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["Connection"]
  node_hosts[("Host settings store<br/>[HostsStore.kt]")]
  node_connect["Connect screen<br/>[ConnectScreen.kt]"]
  node_discovery["Host discovery<br/>[DiscoveryEngine.kt]"]
  node_manager["Connection manager"]
  node_client["Client factory"]
  node_service["Keepalive service"]
end

subgraph group_session["Session and protocol"]
  node_api["Harness API client<br/>[DshApiClient.kt]"]
  node_streams["Remote stream mux<br/>[RemoteStreamMux.kt]"]
  node_store[("Session state<br/>[SessionStore.kt]")]
  node_assistant["Assistant stream<br/>[AssistantStream.kt]"]
end

subgraph group_experience["Harness experience"]
  node_chat["Chat and session views<br/>[ChatScreen.kt]"]
  node_composer["Prompt composer"]
  node_workspace["Workspace panels<br/>[WorkspacePanels.kt]"]
  node_trajectory["Trajectory ledger<br/>[TrajectoryTab.kt]"]
  node_markdown["Markdown rendering<br/>[Markdown.kt]"]
end

subgraph group_app["App shell and settings"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_root["App navigation<br/>[AppRoot.kt]"]
  node_settings["Settings<br/>[SettingsScreen.kt]"]
  node_notifications["Notifications"]
end

node_user(("Phone user"))
node_harness{{"Harness host"}}
node_relay{{"Relay service"}}

node_user -->|"opens app"| node_activity
node_activity -->|"composes"| node_root
node_user -->|"chooses host"| node_connect
node_connect -.->|"scans network"| node_discovery
node_connect -.->|"starts connection"| node_manager
node_discovery -->|"probes host"| node_client
node_manager -->|"builds clients"| node_client
node_manager -->|"remembers host"| node_hosts
node_client -->|"creates API"| node_api
node_client -->|"creates mux"| node_streams
node_api -->|"sends RPC"| node_harness
node_streams -.->|"receives events"| node_harness
node_relay -.->|"secures access"| node_harness
node_manager -->|"starts service"| node_service
node_store -->|"observes connection"| node_manager
node_store -->|"loads session data"| node_api
node_store -->|"folds stream state"| node_assistant
node_root -.->|"shows sessions"| node_chat
node_chat -.->|"renders state"| node_store
node_user -->|"writes prompt"| node_composer
node_composer -->|"keeps drafts"| node_store
node_chat -.->|"submits actions"| node_api
node_chat -.->|"renders messages"| node_markdown
node_chat -.->|"opens previews"| node_workspace
node_chat -.->|"shows ledger"| node_trajectory
node_user -.->|"configures app"| node_settings
node_settings -.->|"updates preferences"| node_hosts
node_store -.->|"signals completion"| node_notifications

click node_activity "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/MainActivity.kt"
click node_root "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/AppRoot.kt"
click node_settings "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/settings/SettingsScreen.kt"
click node_hosts "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/HostsStore.kt"
click node_connect "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/connect/ConnectScreen.kt"
click node_discovery "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/DiscoveryEngine.kt"
click node_manager "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/ConnectionManager.kt"
click node_client "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/HarnessClientFactory.kt"
click node_service "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/ConnectionService.kt"
click node_api "https://github.com/sorsama/deepseek-harness-mobile/blob/main/core/src/main/kotlin/com/labteto/dshmobile/core/wire/DshApiClient.kt"
click node_streams "https://github.com/sorsama/deepseek-harness-mobile/blob/main/core/src/main/kotlin/com/labteto/dshmobile/core/wire/RemoteStreamMux.kt"
click node_store "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/data/SessionStore.kt"
click node_assistant "https://github.com/sorsama/deepseek-harness-mobile/blob/main/core/src/main/kotlin/com/labteto/dshmobile/core/session/AssistantStream.kt"
click node_chat "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/ChatScreen.kt"
click node_composer "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/ComposerRepository.kt"
click node_workspace "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/WorkspacePanels.kt"
click node_trajectory "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/TrajectoryTab.kt"
click node_markdown "https://github.com/sorsama/deepseek-harness-mobile/blob/main/core/src/main/kotlin/com/labteto/dshmobile/core/markdown/Markdown.kt"
click node_notifications "https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/notify/DshNotifications.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_hosts,node_connect,node_discovery,node_manager,node_client,node_service,node_user toneBlue
class node_api,node_streams,node_store,node_assistant toneAmber
class node_chat,node_composer,node_workspace,node_trajectory,node_markdown toneMint
class node_activity,node_root,node_settings,node_notifications toneRose
class node_harness,node_relay toneIndigo
```

## Components

### Connection

- [Host settings store](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/HostsStore.kt): `app/src/main/java/com/labteto/dshmobile/connection/HostsStore.kt`
- [Connect screen](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/connect/ConnectScreen.kt): `app/src/main/java/com/labteto/dshmobile/ui/screens/connect/ConnectScreen.kt`
- [Host discovery](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/DiscoveryEngine.kt): `app/src/main/java/com/labteto/dshmobile/connection/DiscoveryEngine.kt`
- [Connection manager](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/ConnectionManager.kt): `app/src/main/java/com/labteto/dshmobile/connection/ConnectionManager.kt`
- [Client factory](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/HarnessClientFactory.kt): `app/src/main/java/com/labteto/dshmobile/connection/HarnessClientFactory.kt`
- [Keepalive service](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/connection/ConnectionService.kt): `app/src/main/java/com/labteto/dshmobile/connection/ConnectionService.kt`

### Session and protocol

- [Harness API client](https://github.com/sorsama/deepseek-harness-mobile/blob/main/core/src/main/kotlin/com/labteto/dshmobile/core/wire/DshApiClient.kt): `core/src/main/kotlin/com/labteto/dshmobile/core/wire/DshApiClient.kt`
- [Remote stream mux](https://github.com/sorsama/deepseek-harness-mobile/blob/main/core/src/main/kotlin/com/labteto/dshmobile/core/wire/RemoteStreamMux.kt): `core/src/main/kotlin/com/labteto/dshmobile/core/wire/RemoteStreamMux.kt`
- [Session state](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/data/SessionStore.kt): `app/src/main/java/com/labteto/dshmobile/data/SessionStore.kt`
- [Assistant stream](https://github.com/sorsama/deepseek-harness-mobile/blob/main/core/src/main/kotlin/com/labteto/dshmobile/core/session/AssistantStream.kt): `core/src/main/kotlin/com/labteto/dshmobile/core/session/AssistantStream.kt`

### Harness experience

- [Chat and session views](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/ChatScreen.kt): `app/src/main/java/com/labteto/dshmobile/ui/screens/main/ChatScreen.kt`
- [Prompt composer](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/ComposerRepository.kt): `app/src/main/java/com/labteto/dshmobile/ui/screens/main/ComposerRepository.kt`
- [Workspace panels](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/WorkspacePanels.kt): `app/src/main/java/com/labteto/dshmobile/ui/screens/main/WorkspacePanels.kt`
- [Trajectory ledger](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/main/TrajectoryTab.kt): `app/src/main/java/com/labteto/dshmobile/ui/screens/main/TrajectoryTab.kt`
- [Markdown rendering](https://github.com/sorsama/deepseek-harness-mobile/blob/main/core/src/main/kotlin/com/labteto/dshmobile/core/markdown/Markdown.kt): `core/src/main/kotlin/com/labteto/dshmobile/core/markdown/Markdown.kt`

### App shell and settings

- [Main activity](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/MainActivity.kt): `app/src/main/java/com/labteto/dshmobile/MainActivity.kt`
- [App navigation](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/AppRoot.kt): `app/src/main/java/com/labteto/dshmobile/ui/AppRoot.kt`
- [Settings](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/ui/screens/settings/SettingsScreen.kt): `app/src/main/java/com/labteto/dshmobile/ui/screens/settings/SettingsScreen.kt`
- [Notifications](https://github.com/sorsama/deepseek-harness-mobile/blob/main/app/src/main/java/com/labteto/dshmobile/notify/DshNotifications.kt): `app/src/main/java/com/labteto/dshmobile/notify/DshNotifications.kt`

### Other components

- **Phone user**
- **Harness host**
- **Relay service**

## Connections

- Phone user → Main activity: opens app (evidence: `app/src/main/java/com/labteto/dshmobile/MainActivity.kt`)
- Main activity → App navigation: composes (evidence: `app/src/main/java/com/labteto/dshmobile/MainActivity.kt`)
- Phone user → Connect screen: chooses host (evidence: `README.md`)
- Connect screen → Host discovery: scans network (evidence: `README.md`)
- Connect screen → Connection manager: starts connection (evidence: `README.md`)
- Host discovery → Client factory: probes host (evidence: `app/src/main/java/com/labteto/dshmobile/connection/DiscoveryEngine.kt`)
- Connection manager → Client factory: builds clients (evidence: `app/src/main/java/com/labteto/dshmobile/connection/ConnectionManager.kt`)
- Connection manager → Host settings store: remembers host (evidence: `app/src/main/java/com/labteto/dshmobile/connection/ConnectionManager.kt`)
- Client factory → Harness API client: creates API (evidence: `app/src/main/java/com/labteto/dshmobile/connection/HarnessClientFactory.kt`)
- Client factory → Remote stream mux: creates mux (evidence: `app/src/main/java/com/labteto/dshmobile/connection/HarnessClientFactory.kt`)
- Harness API client → Harness host: sends RPC (evidence: `core/src/main/kotlin/com/labteto/dshmobile/core/wire/DshApiClient.kt`)
- Remote stream mux → Harness host: receives events
- Relay service → Harness host: secures access (evidence: `README.md`)
- Connection manager → Keepalive service: starts service (evidence: `app/src/main/java/com/labteto/dshmobile/connection/ConnectionManager.kt`)
- Session state → Connection manager: observes connection (evidence: `app/src/main/java/com/labteto/dshmobile/data/SessionStore.kt`)
- Session state → Harness API client: loads session data (evidence: `app/src/main/java/com/labteto/dshmobile/data/SessionStore.kt`)
- Session state → Assistant stream: folds stream state (evidence: `app/src/main/java/com/labteto/dshmobile/data/SessionStore.kt`)
- App navigation → Chat and session views: shows sessions (evidence: `README.md`)
- Chat and session views → Session state: renders state (evidence: `README.md`)
- Phone user → Prompt composer: writes prompt (evidence: `README.md`)
- Prompt composer → Session state: keeps drafts (evidence: `app/src/main/java/com/labteto/dshmobile/ui/screens/main/ComposerRepository.kt`)
- Chat and session views → Harness API client: submits actions (evidence: `README.md`)
- Chat and session views → Markdown rendering: renders messages (evidence: `README.md`)
- Chat and session views → Workspace panels: opens previews (evidence: `README.md`)
- Chat and session views → Trajectory ledger: shows ledger (evidence: `README.md`)
- Phone user → Settings: configures app (evidence: `README.md`)
- Settings → Host settings store: updates preferences (evidence: `README.md`)
- Session state → Notifications: signals completion (evidence: `README.md`)
