How johnteller722/deepseek-harness works
DeepSeek Harness is a plugin-oriented agent harness with a Web UI and Desktop host. The documented user path is launching dsh web, which starts the local UI; the broader runtime includes session management and persistence, API transport, plugin tooling, and optional extensions. The graph preserves major subsystems visible in the tree and source index. Several internal connections are not shown because the sampled excerpts do not establish their callers; those paths are therefore left unconnected.
Main entry points: manager.ts Session manager · bin.ts DSH CLI · session.ts Session instances · storage.ts Session persistence
Components 22
Agent runtime
- Session manager
packages/api/session-controller/src/client/sessions/manager.ts - Session instances
packages/api/session-controller/src/client/sessions/session.ts - Session contracts
packages/api/session-controller/src/client/contract/session.ts - Session persistence
packages/session/session-persistence-jsonl/src/storage.ts - Persistence validation
packages/session/session-persistence/src/storage-contract.ts - Scheduled tasks
packages/schedule/schedule/src/storage.ts
Client and APIs
- API gateway
packages/api/gateway/src/stream-server.ts - Client connection
packages/client/connection/src/client/connection.ts - Workspace API
packages/api/workspace-controller/src/commands.ts - Terminal API
packages/api/terminal-controller/src/terminal.ts - SDK server
packages/sdk/server/src/server.ts
Plugins and extensions
- Plugin manager UI
packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx - Plugin manager
packages/boot/plugin-manager/src/operations.ts - Claude Code mods
packages/experimental/claude-code-mods/src/engine.ts - Runtime inspector
packages/experimental/inspector/src/worker/inspection/query-router.ts
Desktop product
- Desktop app
apps/desktop/src/main.ts - Desktop host
apps/desktop-host/src/office-engine.ts - Project manager
apps/desktop/src/project-manager.ts - Runtime tree
apps/desktop/src/runtime-tree.ts
Other components
- User
Connections 7
- User → DSH CLI: launches
README.md - DSH CLI → Web UI: starts
README.md - Project manager → Runtime tree: validates
apps/desktop/src/project-manager.ts - Session manager → API gateway: checks remote failures
packages/api/session-controller/src/client/sessions/manager.ts - Session persistence → Persistence validation: materializes writes
packages/session/session-persistence-jsonl/src/storage.ts - Session manager → Session instances: constructs sessions
packages/api/session-controller/src/client/sessions/manager.ts - Session instances → Session contracts: uses contract
packages/api/session-controller/src/client/sessions/session.ts