# midea-ai/sema-code-core architecture

> Architecture diagram of the GitHub repository midea-ai/sema-code-core, 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/midea-ai/sema-code-core
- Repository: https://github.com/midea-ai/sema-code-core

## Overview

Sema Core is an event-driven AI coding-assistant engine intended to be embedded in developer tools. A client configures the engine, submits coding work, and receives results and session events; the engine coordinates model interaction, tools, and session state. Multi-agent collaboration, Plan mode, Skills, and plugin-based extensions are documented capabilities. The repository also includes SemaWork and language SDKs. Several runtime relationships are only suggested by the sampled material, so those links are marked unverified rather than presented as inspected calls.

Main entry points: [`src/core/SemaEngine.ts`](https://github.com/midea-ai/sema-code-core/blob/main/src/core/SemaEngine.ts) (Turn Engine), [`webui/server/src/server.ts`](https://github.com/midea-ai/sema-code-core/blob/main/webui/server/src/server.ts) (SemaWork Server), [`src/core/SemaCore.ts`](https://github.com/midea-ai/sema-code-core/blob/main/src/core/SemaCore.ts) (Sema Core API), [`src/services/plugins/pluginsManager.ts`](https://github.com/midea-ai/sema-code-core/blob/main/src/services/plugins/pluginsManager.ts) (Plugin Extensions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engine["Core Engine"]
  node_core["Sema Core API<br/>[SemaCore.ts]"]
  node_engine_runtime["Turn Engine<br/>[SemaEngine.ts]"]
  node_session["Session API<br/>[SemaSession.ts]"]
  node_session_state["Session State<br/>[StateManager.ts]"]
  node_events["Event Bus<br/>[EventSystem.ts]"]
  node_model_api["Model Adapters"]
end

subgraph group_capabilities["Agent Capabilities"]
  node_tool_runtime["Tool Runtime<br/>[tools.ts]"]
  node_permission["Permissions"]
  node_agents["Agent Extensions<br/>[agentsManager.ts]"]
  node_plugins["Plugin Extensions<br/>[pluginsManager.ts]"]
  node_skills["Skills<br/>[skillsManager.ts]"]
  node_mcp["MCP Servers<br/>[MCPManager.ts]"]
end

subgraph group_workbench["SemaWork"]
  node_web_client["SemaWork UI<br/>[App.tsx]"]
  node_web_server["SemaWork Server<br/>[server.ts]"]
  node_web_sessions["Web Sessions<br/>[sessions.ts]"]
  node_websocket["WebSocket Handler<br/>[handler.ts]"]
end

subgraph group_integrations["Embedding Interfaces"]
  node_sdk_bridge["Shared Bridge<br/>[server.ts]"]
  node_sdk_java["Java SDK<br/>[SemaCore.java]"]
  node_sdk_python["Python SDK<br/>[api.py]"]
  node_sdk_csharp["C&#35; SDK<br/>[SemaCore.cs]"]
end

node_developer(("Developer"))

node_developer -.->|"configures and calls"| node_core
node_core -.->|"runs turns"| node_engine_runtime
node_engine_runtime -.->|"emits events"| node_events
node_engine_runtime -.->|"updates state"| node_session_state
node_engine_runtime -.->|"queries models"| node_model_api
node_engine_runtime -.->|"uses tools"| node_tool_runtime
node_tool_runtime -.->|"checks access"| node_permission
node_engine_runtime -.->|"coordinates agents"| node_agents
node_plugins -->|"provides extensions"| node_skills
node_plugins -.->|"manages integration"| node_mcp
node_developer -->|"uses workbench"| node_web_client
node_web_client -.->|"communicates with"| node_web_server
node_web_server -->|"uses sessions"| node_web_sessions
node_web_server -->|"registers handler"| node_websocket
node_developer -->|"integrates through"| node_sdk_java
node_developer -->|"integrates through"| node_sdk_python
node_developer -->|"integrates through"| node_sdk_csharp
node_sdk_bridge -.->|"bridges to engine"| node_core

click node_core "https://github.com/midea-ai/sema-code-core/blob/main/src/core/SemaCore.ts"
click node_engine_runtime "https://github.com/midea-ai/sema-code-core/blob/main/src/core/SemaEngine.ts"
click node_session "https://github.com/midea-ai/sema-code-core/blob/main/src/core/SemaSession.ts"
click node_session_state "https://github.com/midea-ai/sema-code-core/blob/main/src/manager/StateManager.ts"
click node_events "https://github.com/midea-ai/sema-code-core/blob/main/src/events/EventSystem.ts"
click node_model_api "https://github.com/midea-ai/sema-code-core/tree/main/src/services/api"
click node_tool_runtime "https://github.com/midea-ai/sema-code-core/blob/main/src/tools/base/tools.ts"
click node_permission "https://github.com/midea-ai/sema-code-core/blob/main/src/manager/PermissionManager.ts"
click node_agents "https://github.com/midea-ai/sema-code-core/blob/main/src/services/agents/agentsManager.ts"
click node_plugins "https://github.com/midea-ai/sema-code-core/blob/main/src/services/plugins/pluginsManager.ts"
click node_skills "https://github.com/midea-ai/sema-code-core/blob/main/src/services/skills/skillsManager.ts"
click node_mcp "https://github.com/midea-ai/sema-code-core/blob/main/src/services/mcp/MCPManager.ts"
click node_web_client "https://github.com/midea-ai/sema-code-core/blob/main/webui/client/src/app/App.tsx"
click node_web_server "https://github.com/midea-ai/sema-code-core/blob/main/webui/server/src/server.ts"
click node_web_sessions "https://github.com/midea-ai/sema-code-core/blob/main/webui/server/src/sessions.ts"
click node_websocket "https://github.com/midea-ai/sema-code-core/blob/main/webui/server/src/ws/handler.ts"
click node_sdk_bridge "https://github.com/midea-ai/sema-code-core/blob/main/sdks/shared/bridge/src/server.ts"
click node_sdk_java "https://github.com/midea-ai/sema-code-core/blob/main/sdks/java/src/main/java/semacore/SemaCore.java"
click node_sdk_python "https://github.com/midea-ai/sema-code-core/blob/main/sdks/python/src/sema_core/api.py"
click node_sdk_csharp "https://github.com/midea-ai/sema-code-core/blob/main/sdks/csharp/Api/SemaCore.cs"

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_core,node_engine_runtime,node_session,node_session_state,node_events,node_model_api toneBlue
class node_tool_runtime,node_permission,node_agents,node_plugins,node_skills,node_mcp toneAmber
class node_web_client,node_web_server,node_web_sessions,node_websocket toneMint
class node_sdk_bridge,node_sdk_java,node_sdk_python,node_sdk_csharp toneRose
class node_developer toneIndigo
```

## Components

### Core Engine

- [Sema Core API](https://github.com/midea-ai/sema-code-core/blob/main/src/core/SemaCore.ts): `src/core/SemaCore.ts`
- [Turn Engine](https://github.com/midea-ai/sema-code-core/blob/main/src/core/SemaEngine.ts): `src/core/SemaEngine.ts`
- [Session API](https://github.com/midea-ai/sema-code-core/blob/main/src/core/SemaSession.ts): `src/core/SemaSession.ts`
- [Session State](https://github.com/midea-ai/sema-code-core/blob/main/src/manager/StateManager.ts): `src/manager/StateManager.ts`
- [Event Bus](https://github.com/midea-ai/sema-code-core/blob/main/src/events/EventSystem.ts): `src/events/EventSystem.ts`
- [Model Adapters](https://github.com/midea-ai/sema-code-core/tree/main/src/services/api): `src/services/api`

### Agent Capabilities

- [Tool Runtime](https://github.com/midea-ai/sema-code-core/blob/main/src/tools/base/tools.ts): `src/tools/base/tools.ts`
- [Permissions](https://github.com/midea-ai/sema-code-core/blob/main/src/manager/PermissionManager.ts): `src/manager/PermissionManager.ts`
- [Agent Extensions](https://github.com/midea-ai/sema-code-core/blob/main/src/services/agents/agentsManager.ts): `src/services/agents/agentsManager.ts`
- [Plugin Extensions](https://github.com/midea-ai/sema-code-core/blob/main/src/services/plugins/pluginsManager.ts): `src/services/plugins/pluginsManager.ts`
- [Skills](https://github.com/midea-ai/sema-code-core/blob/main/src/services/skills/skillsManager.ts): `src/services/skills/skillsManager.ts`
- [MCP Servers](https://github.com/midea-ai/sema-code-core/blob/main/src/services/mcp/MCPManager.ts): `src/services/mcp/MCPManager.ts`

### SemaWork

- [SemaWork UI](https://github.com/midea-ai/sema-code-core/blob/main/webui/client/src/app/App.tsx): `webui/client/src/app/App.tsx`
- [SemaWork Server](https://github.com/midea-ai/sema-code-core/blob/main/webui/server/src/server.ts): `webui/server/src/server.ts`
- [Web Sessions](https://github.com/midea-ai/sema-code-core/blob/main/webui/server/src/sessions.ts): `webui/server/src/sessions.ts`
- [WebSocket Handler](https://github.com/midea-ai/sema-code-core/blob/main/webui/server/src/ws/handler.ts): `webui/server/src/ws/handler.ts`

### Embedding Interfaces

- [Shared Bridge](https://github.com/midea-ai/sema-code-core/blob/main/sdks/shared/bridge/src/server.ts): `sdks/shared/bridge/src/server.ts`
- [Java SDK](https://github.com/midea-ai/sema-code-core/blob/main/sdks/java/src/main/java/semacore/SemaCore.java): `sdks/java/src/main/java/semacore/SemaCore.java`
- [Python SDK](https://github.com/midea-ai/sema-code-core/blob/main/sdks/python/src/sema_core/api.py): `sdks/python/src/sema_core/api.py`
- [C# SDK](https://github.com/midea-ai/sema-code-core/blob/main/sdks/csharp/Api/SemaCore.cs): `sdks/csharp/Api/SemaCore.cs`

### Other components

- **Developer**

## Connections

- Developer → Sema Core API: configures and calls (evidence: `README.md`)
- Sema Core API → Turn Engine: runs turns
- Turn Engine → Event Bus: emits events (evidence: `src/core/SemaEngine.ts`)
- Turn Engine → Session State: updates state (evidence: `src/core/SemaEngine.ts`)
- Turn Engine → Model Adapters: queries models
- Turn Engine → Tool Runtime: uses tools (evidence: `src/core/SemaEngine.ts`)
- Tool Runtime → Permissions: checks access
- Turn Engine → Agent Extensions: coordinates agents
- Plugin Extensions → Skills: provides extensions (evidence: `src/services/skills/skillsManager.ts`)
- Plugin Extensions → MCP Servers: manages integration (evidence: `src/services/plugins/pluginsManager.ts`)
- Developer → SemaWork UI: uses workbench (evidence: `README.md`)
- SemaWork UI → SemaWork Server: communicates with
- SemaWork Server → Web Sessions: uses sessions (evidence: `webui/server/src/server.ts`)
- SemaWork Server → WebSocket Handler: registers handler (evidence: `webui/server/src/server.ts`)
- Developer → Java SDK: integrates through (evidence: `README.md`)
- Developer → Python SDK: integrates through (evidence: `README.md`)
- Developer → C# SDK: integrates through (evidence: `README.md`)
- Shared Bridge → Sema Core API: bridges to engine
