How manikandan1511/deepseek-harness works
DeepSeek Harness is a plugin-oriented agent harness with a Web UI and CLI launch path. The user-facing workflow starts the local web experience; inside the runtime, session management, tool execution, subagents, scheduling, and durable session storage are distinct capabilities. The excerpts support some session-client and persistence links, but do not show the web server’s internal startup wiring or most plugin/runtime integration, so those links are omitted or marked unverified.
Main entry points: manager.ts Session client manager · session.ts Session instances · bin.ts DSH CLI · main.ts Web UI
Components 16
Harness runtime
- Subagent manager
packages/subagent/subagent/src/manager.ts - Schedule storage
packages/schedule/schedule/src/storage.ts - SDK server
packages/sdk/server/src/server.ts
Session services
- Session client manager
packages/api/session-controller/src/client/sessions/manager.ts - Session instances
packages/api/session-controller/src/client/sessions/session.ts - Session projections
packages/api/session-controller/src/client/sessions/projection-store.ts - Session notifier
packages/api/session-controller/src/client/sessions/notifier.ts - Gateway client
packages/api/gateway/src/client/index.ts - Persistence contract
packages/session/session-persistence/src/storage-contract.ts - JSONL persistence
packages/session/session-persistence-jsonl/src/storage.ts
Plugins and tools
- Plugin manager UI
packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx - Tool execution
packages/core/tools/src/pipeline.ts - Mods engine
packages/experimental/claude-code-mods/src/engine.ts
Other components
- User
Connections 10
- User → DSH CLI: launches
README.md - DSH CLI → Web UI: starts UI
README.md - Session client manager → Session instances: constructs
packages/api/session-controller/src/client/sessions/manager.ts - Session client manager → Session projections: uses
packages/api/session-controller/src/client/sessions/manager.ts - Session instances → Session notifier: uses
packages/api/session-controller/src/client/sessions/session.ts - Session instances → Session projections: uses
packages/api/session-controller/src/client/sessions/session.ts - Session client manager → Gateway client: checks failures
packages/api/session-controller/src/client/sessions/manager.ts - JSONL persistence → Persistence contract: materializes batches
packages/session/session-persistence-jsonl/src/storage.ts - Web UI → Plugin manager UI: hosts
- Tool execution → Mods engine: integrates