How lacania/deepseek-harness works
DeepSeek Harness is a plugin-oriented agent harness whose documented user entry point is a local Web UI. The visible browser bootstrap starts the app shell, which assembles a slot-based interface; client runtime modules manage sessions and workspaces, while conversation UI provides chat, submission, and related controls. API remotes and the connection client represent the wire boundary. The tree also shows search/export and settings capabilities. Several runtime connections are inferred from module responsibilities, so edges are limited to relationships supported by the sampled code or README.
Main entry points: service.ts Conversation UI · app.tsx Web assembly · manager.ts Session manager · main.ts Web bootstrap
Components 22
App entry
- Web bootstrap
apps/web/src/main.ts - Web assembly
packages/client/web/src/app.tsx - Web startup
packages/bundle/web-app/src/startup.ts - App layout
packages/client/ui-layout/src/client/AppFrame.tsx
Client runtime
- Session manager
packages/client/runtime/src/client/sessions/manager.ts - Workspace manager
packages/client/runtime/src/client/workspaces/manager.ts - Client runtime API
packages/client/runtime/src/client/index.ts
Conversation UI
- Conversation UI
packages/client/ui-conversation/src/client/service.ts - Chat rendering
packages/client/ui-conversation/src/client/chat/ChatView.tsx - Input triggers
packages/client/ui-input-trigger/src/client/controller.ts - Attachment UI
packages/client/ui-attachment/src/AttachmentRail.tsx
Client services
- API gateway
packages/api/gateway/src/index.ts - API remotes
packages/api/remotes/src/index.ts - Client connection
packages/client/connection/src/client/connection.ts - Model settings
packages/client/ui-settings-models/src/client/store.ts - Client modules
packages/client/modules/src/client/system.ts - Session search
packages/session-query/session-query-sqlite/src/query.ts - Session export
packages/session-query/session-log-export/src/client/controller.ts - Message feedback
packages/client/ui-message-feedback/src/client/controller.ts - SDK server
packages/sdk/server/src/server.ts
Other components
- Web user
- Harness host
Connections 17
- Web user → Web bootstrap: opens UI
- Web bootstrap → Web startup: starts app
- Web startup → Web assembly: assembles UI
- Web assembly → App layout: renders root slot
- Web assembly → Session manager: reads session list
- Session manager → API remotes: uses remote API
- Workspace manager → API remotes: uses wire client
- Client connection → API gateway: connects API
- Conversation UI → Session manager: session views
- Conversation UI → Chat rendering: renders chat
- Conversation UI → Input triggers: handles triggers
- Conversation UI → Attachment UI: shows attachments
- Model settings → Client connection: settings requests
- Session export → Harness host: fetches export
- Message feedback → Harness host: mutates feedback
- SDK server → Harness host: uses agent context
- Client modules → Web assembly: extends client