# dayuanjiang/next-ai-draw-io architecture

> Architecture diagram of the GitHub repository dayuanjiang/next-ai-draw-io, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dayuanjiang/next-ai-draw-io
- Repository: https://github.com/dayuanjiang/next-ai-draw-io

## Overview

Next AI Draw.io turns user prompts, attachments, or selected canvas content into editable draw.io diagrams. The main web workflow streams AI responses into diagram operations, applies them to the embedded editor, and tracks versions in local browser storage. The repository also provides diagram validation, provider configuration, a desktop wrapper, and an MCP server for agent-driven drawing. Relationships for sampled modules use source-index references or excerpts; broader product flows rely on README statements, and unsampled internals are not inferred.

Main entry points: [`components/chat/chat-engine.tsx`](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/components/chat/chat-engine.tsx) (Chat workflow), [`hooks/use-diagram-tool-handlers.ts`](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/hooks/use-diagram-tool-handlers.ts) (Diagram tools), [`packages/mcp-server/src/http-server.ts`](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/src/http-server.ts) (MCP server), [`hooks/use-session-manager.ts`](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/hooks/use-session-manager.ts) (Session manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workspace"]
  node_chat["Chat workflow<br/>[chat-engine.tsx]"]
  node_tool_handlers["Diagram tools"]
  node_sessions["Session manager"]
  node_session_db[("Local sessions<br/>[session-storage.ts]")]
end

subgraph group_diagram["Diagram editing"]
  node_diagram_context["Canvas context"]
  node_editor_bridge["Editor bridge<br/>[editor-bridge.ts]"]
  node_page_model["Page operations<br/>[pages.ts]"]
  node_canvas_state[("Canvas state<br/>[canvas-store.ts]")]
  node_version_state[("Version history<br/>[versions-store.ts]")]
end

subgraph group_ai["AI services"]
  node_chat_api["Chat endpoint<br/>[route.ts]"]
  node_provider_runtime["Model providers<br/>[ai-providers.ts]"]
  node_provider_catalog["Provider catalog<br/>[providers.ts]"]
  node_diagram_validation["Diagram validation<br/>[route.ts]"]
  node_admin_settings["Admin settings<br/>[settings.ts]"]
end

subgraph group_mcp["MCP server"]
  node_mcp_http["MCP server<br/>[http-server.ts]"]
  node_mcp_new["Create diagram<br/>[new-diagram.ts]"]
  node_mcp_shell["Canvas shell<br/>[main.tsx]"]
end

subgraph group_desktop["Desktop app"]
  node_desktop_main["Desktop runtime<br/>[index.ts]"]
end

node_user(("User or agent"))

node_user -->|"describes diagram"| node_chat
node_chat -->|"requests generation"| node_chat_api
node_chat_api -->|"resolves model"| node_provider_runtime
node_provider_runtime -->|"uses providers"| node_provider_catalog
node_chat -->|"dispatches edits"| node_tool_handlers
node_tool_handlers -->|"applies changes"| node_diagram_context
node_diagram_context -->|"updates canvas"| node_editor_bridge
node_editor_bridge -->|"updates state"| node_canvas_state
node_tool_handlers -->|"operates pages"| node_page_model
node_chat -->|"manages conversations"| node_sessions
node_sessions -->|"reads and writes"| node_session_db
node_chat -->|"tracks changes"| node_version_state
node_user -->|"requests review"| node_diagram_validation
node_user -->|"invokes agent tools"| node_mcp_http
node_mcp_http -.->|"creates diagrams"| node_mcp_new
node_mcp_http -->|"serves canvas"| node_mcp_shell
node_user -->|"uses desktop app"| node_desktop_main
node_user -.->|"configures service"| node_admin_settings

click node_chat "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/components/chat/chat-engine.tsx"
click node_tool_handlers "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/hooks/use-diagram-tool-handlers.ts"
click node_sessions "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/hooks/use-session-manager.ts"
click node_session_db "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/session-storage.ts"
click node_diagram_context "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/contexts/diagram-context.tsx"
click node_editor_bridge "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/drawio/editor-bridge.ts"
click node_page_model "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/src/pages.ts"
click node_canvas_state "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/stores/canvas-store.ts"
click node_version_state "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/stores/versions-store.ts"
click node_chat_api "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/app/api/chat/route.ts"
click node_provider_runtime "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/ai-providers.ts"
click node_provider_catalog "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/providers.ts"
click node_diagram_validation "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/app/api/validate-diagram/route.ts"
click node_admin_settings "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/admin/settings.ts"
click node_mcp_http "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/src/http-server.ts"
click node_mcp_new "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/src/new-diagram.ts"
click node_mcp_shell "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/shell/main.tsx"
click node_desktop_main "https://github.com/dayuanjiang/next-ai-draw-io/blob/main/electron/main/index.ts"

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_chat,node_tool_handlers,node_sessions,node_session_db,node_user toneBlue
class node_diagram_context,node_editor_bridge,node_page_model,node_canvas_state,node_version_state toneAmber
class node_chat_api,node_provider_runtime,node_provider_catalog,node_diagram_validation,node_admin_settings toneMint
class node_mcp_http,node_mcp_new,node_mcp_shell toneRose
class node_desktop_main toneIndigo
```

## Components

### Web workspace

- [Chat workflow](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/components/chat/chat-engine.tsx): `components/chat/chat-engine.tsx`
- [Diagram tools](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/hooks/use-diagram-tool-handlers.ts): `hooks/use-diagram-tool-handlers.ts`
- [Session manager](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/hooks/use-session-manager.ts): `hooks/use-session-manager.ts`
- [Local sessions](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/session-storage.ts): `lib/session-storage.ts`

### Diagram editing

- [Canvas context](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/contexts/diagram-context.tsx): `contexts/diagram-context.tsx`
- [Editor bridge](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/drawio/editor-bridge.ts): `lib/drawio/editor-bridge.ts`
- [Page operations](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/src/pages.ts): `packages/mcp-server/src/pages.ts`
- [Canvas state](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/stores/canvas-store.ts): `stores/canvas-store.ts`
- [Version history](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/stores/versions-store.ts): `stores/versions-store.ts`

### AI services

- [Chat endpoint](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/app/api/chat/route.ts): `app/api/chat/route.ts`
- [Model providers](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/ai-providers.ts): `lib/ai-providers.ts`
- [Provider catalog](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/providers.ts): `lib/providers.ts`
- [Diagram validation](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/app/api/validate-diagram/route.ts): `app/api/validate-diagram/route.ts`
- [Admin settings](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/lib/admin/settings.ts): `lib/admin/settings.ts`

### MCP server

- [MCP server](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/src/http-server.ts): `packages/mcp-server/src/http-server.ts`
- [Create diagram](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/src/new-diagram.ts): `packages/mcp-server/src/new-diagram.ts`
- [Canvas shell](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/packages/mcp-server/shell/main.tsx): `packages/mcp-server/shell/main.tsx`

### Desktop app

- [Desktop runtime](https://github.com/dayuanjiang/next-ai-draw-io/blob/main/electron/main/index.ts): `electron/main/index.ts`

### Other components

- **User or agent**

## Connections

- User or agent → Chat workflow: describes diagram
- Chat workflow → Chat endpoint: requests generation
- Chat endpoint → Model providers: resolves model (evidence: `app/api/chat/route.ts`)
- Model providers → Provider catalog: uses providers
- Chat workflow → Diagram tools: dispatches edits (evidence: `components/chat/chat-engine.tsx`)
- Diagram tools → Canvas context: applies changes (evidence: `hooks/use-diagram-tool-handlers.ts`)
- Canvas context → Editor bridge: updates canvas (evidence: `contexts/diagram-context.tsx`)
- Editor bridge → Canvas state: updates state (evidence: `lib/drawio/editor-bridge.ts`)
- Diagram tools → Page operations: operates pages (evidence: `hooks/use-diagram-tool-handlers.ts`)
- Chat workflow → Session manager: manages conversations (evidence: `components/chat/chat-engine.tsx`)
- Session manager → Local sessions: reads and writes (evidence: `hooks/use-session-manager.ts`)
- Chat workflow → Version history: tracks changes (evidence: `components/chat/chat-engine.tsx`)
- User or agent → Diagram validation: requests review
- User or agent → MCP server: invokes agent tools
- MCP server → Create diagram: creates diagrams
- MCP server → Canvas shell: serves canvas (evidence: `packages/mcp-server/shell/main.tsx`)
- User or agent → Desktop runtime: uses desktop app
- User or agent → Admin settings: configures service
