How eighteendreamer/deepagent-studio works
DeepAgent Studio is an agent-runtime platform with a Tauri/React desktop IDE and a headless CLI. The main workflow is a user prompt entering through a client, being assembled into context and handled by the agent loop, which calls tools under hooks and approval controls before returning a streamed result. The README documents additional session, memory, verification, subagent, MCP, plugin, and workflow-canvas capabilities. Some subsystem links reflect README descriptions because their implementation files were not sampled.
Main entry points: loop_engine.rs Agent loop · chat_service.rs App services · tool_pipeline.rs Tool execution · App.tsx Desktop IDE
Components 23
User clients
- Desktop IDE
apps/desktop/src/App.tsx - Headless CLI
apps/cli/src/main.rs - Tauri bridge
apps/desktop/src-tauri/src/lib.rs - Desktop API
apps/desktop/src/api.ts - Workflow canvas
apps/desktop/src/canvas/workflow/utils/workflowExecutor.ts
Application services
- App services
crates/deepagent-app-core/src/chat_service.rs - Session state
crates/deepagent-app-core/src/session_state_service.rs - File preview
crates/deepagent-app-core/src/file_preview_service.rs
Agent runtime
- Context pipeline
crates/deepagent-context/src/pipeline.rs - Agent loop
crates/deepagent-runtime/src/loop_engine.rs - Tool execution
crates/deepagent-runtime/src/tool_pipeline.rs - Hooks and policy
crates/deepagent-hooks/src/lifecycle.rs - Self-healing checks
crates/deepagent-app-core/src/verification_dispatcher.rs - Subagent orchestration
crates/deepagent-app-core/src/subagent_runner.rs - Model runtime
crates/deepagent-app-core/src/model_runtime.rs
Tools and extensions
- Built-in tools
crates/deepagent-builtins/src/lib.rs - MCP integrations
crates/deepagent-mcp/src/client.rs - Plugins and skills
crates/deepagent-app-core/src/plugin_service.rs
Knowledge and projects
- Knowledge retrieval
crates/deepagent-memory/src/contextual_retrieval.rs - Code graph
crates/deepagent-codegraph/src/query.rs - Workspace services
crates/deepagent-app-core/src/workspace_service.rs
Other components
- User
- DeepSeek API
Connections 23
- User → Desktop IDE: prompts
- User → Headless CLI: prompts
- Desktop IDE → Desktop API: invokes
- Desktop API → Tauri bridge: dispatches
- Tauri bridge → App services: calls
- Headless CLI → App services: builds chat service
- App services → Session state: manages sessions
- App services → Agent loop: runs agent
- Agent loop → Context pipeline: assembles prompt
- Agent loop → Model runtime: requests completion
- Model runtime → DeepSeek API: streams responses
- Agent loop → Tool execution: dispatches tools
- Tool execution → Built-in tools: executes
- Tool execution → Hooks and policy: checks lifecycle
- Agent loop → Self-healing checks: verifies
- Agent loop → Subagent orchestration: delegates
- Tool execution → MCP integrations: calls remote tools
- App services → Plugins and skills: manages extensions
- Context pipeline → Knowledge retrieval: retrieves context
- Context pipeline → Workspace services: adds workspace context
- App services → Code graph: queries code graph
- Desktop API → File preview: requests preview
- Desktop IDE → Workflow canvas: runs workflows