How dayuanjiang/next-ai-draw-io works
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: chat-engine.tsx Chat workflow · use-diagram-tool-handlers.ts Diagram tools · http-server.ts MCP server · use-session-manager.ts Session manager
Components 19
Web workspace
- Chat workflow
components/chat/chat-engine.tsx - Diagram tools
hooks/use-diagram-tool-handlers.ts - Session manager
hooks/use-session-manager.ts - Local sessions
lib/session-storage.ts
Diagram editing
- Canvas context
contexts/diagram-context.tsx - Editor bridge
lib/drawio/editor-bridge.ts - Page operations
packages/mcp-server/src/pages.ts - Canvas state
stores/canvas-store.ts - Version history
stores/versions-store.ts
AI services
- Chat endpoint
app/api/chat/route.ts - Model providers
lib/ai-providers.ts - Provider catalog
lib/providers.ts - Diagram validation
app/api/validate-diagram/route.ts - Admin settings
lib/admin/settings.ts
MCP server
- MCP server
packages/mcp-server/src/http-server.ts - Create diagram
packages/mcp-server/src/new-diagram.ts - Canvas shell
packages/mcp-server/shell/main.tsx
Desktop app
- Desktop runtime
electron/main/index.ts
Other components
- User or agent
Connections 18
- User or agent → Chat workflow: describes diagram
- Chat workflow → Chat endpoint: requests generation
- Chat endpoint → Model providers: resolves model
app/api/chat/route.ts - Model providers → Provider catalog: uses providers
- Chat workflow → Diagram tools: dispatches edits
components/chat/chat-engine.tsx - Diagram tools → Canvas context: applies changes
hooks/use-diagram-tool-handlers.ts - Canvas context → Editor bridge: updates canvas
contexts/diagram-context.tsx - Editor bridge → Canvas state: updates state
lib/drawio/editor-bridge.ts - Diagram tools → Page operations: operates pages
hooks/use-diagram-tool-handlers.ts - Chat workflow → Session manager: manages conversations
components/chat/chat-engine.tsx - Session manager → Local sessions: reads and writes
hooks/use-session-manager.ts - Chat workflow → Version history: tracks changes
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
packages/mcp-server/shell/main.tsx - User or agent → Desktop runtime: uses desktop app
- User or agent → Admin settings: configures service