# eslammohamedk123450-netizen/smsm-ai architecture

> Architecture diagram of the GitHub repository eslammohamedk123450-netizen/smsm-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eslammohamedk123450-netizen/smsm-ai
- Repository: https://github.com/eslammohamedk123450-netizen/smsm-ai

## Overview

SULY AI is a mobile/web AI assistant with chat, long-running agent tasks, media creation and management, integrations, and administrative controls. Users authenticate, submit chat or agent work, and receive streamed responses or queued-task results; media uploads and generation form a distinct workflow. The README establishes the central router and task queue; sampled sources support client streaming, media upload, auth, and provider racing. Many screens and edge-function internals are unsampled, so their undocumented call relationships are omitted.

Main entry points: [`supabase/functions/ai-router/index.ts`](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/index.ts) (AI Router), [`apps/mobile/src/lib/supabase/client.ts`](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/lib/supabase/client.ts) (Supabase Client), [`apps/mobile/src/features/media/ImageStudioScreen.tsx`](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/media/ImageStudioScreen.tsx) (Media Studio), [`apps/mobile/src/features/admin/admin-service.ts`](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/admin/admin-service.ts) (Admin Controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile Client"]
  node_auth["Authentication<br/>[auth-service.ts]"]
  node_supabase["Supabase Client<br/>[client.ts]"]
end

subgraph group_conversation["Chat and Agents"]
  node_chatui["Chat Experience"]
  node_chatservice["Chat Service<br/>[chat-service.ts]"]
  node_streammanager["Stream Manager"]
  node_sse["SSE Transport<br/>[sse-transport.ts]"]
  node_brainui["Agent Tasks"]
  node_brainservice["Brain Service<br/>[brain-service.ts]"]
end

subgraph group_media["Media Workflows"]
  node_mediaui["Media Studio"]
  node_mediaservice["Media Service<br/>[media-service.ts]"]
  node_mediagateway["Media Gateway<br/>[index.ts]"]
  node_imagegen["Image Generation<br/>[index.ts]"]
end

subgraph group_backend["AI Backend"]
  node_taskqueue["Task Queue<br/>[index.ts]"]
  node_taskworker["Task Worker<br/>[index.ts]"]
  node_router["AI Router<br/>[index.ts]"]
  node_orchestrator["Agent Orchestrator<br/>[orchestrator.ts]"]
  node_racing["Provider Racing<br/>[racing_engine.ts]"]
  node_provider["Model Providers"]
end

subgraph group_operations["Admin and Services"]
  node_integrations["Connected Apps"]
  node_admin["Admin Controls<br/>[admin-service.ts]"]
  node_storageadmin["Storage Browser"]
  node_support["Support<br/>[support-service.ts]"]
  node_database[("Supabase Data<br/>[client.ts]")]
end

node_user(("User"))

node_user -->|"signs in"| node_auth
node_auth -->|"authenticates with"| node_supabase
node_user -.->|"submits chat"| node_chatui
node_chatui -->|"requests chat"| node_chatservice
node_chatservice -->|"starts stream"| node_streammanager
node_streammanager -->|"streams through"| node_sse
node_sse -.->|"sends requests"| node_router
node_user -->|"requests task"| node_brainui
node_brainui -->|"runs task"| node_brainservice
node_brainservice -.->|"enqueues task"| node_taskqueue
node_taskqueue -.->|"dispatches jobs"| node_taskworker
node_taskworker -.->|"executes via"| node_router
node_router -.->|"coordinates agents"| node_orchestrator
node_router -.->|"routes models"| node_racing
node_racing -->|"races providers"| node_provider
node_user -.->|"creates media"| node_mediaui
node_mediaui -.->|"uploads media"| node_mediaservice
node_mediaservice -->|"requests upload"| node_mediagateway
node_mediaui -.->|"generates images"| node_imagegen
node_user -.->|"connects apps"| node_integrations
node_user -.->|"manages platform"| node_admin
node_admin -->|"uses client"| node_supabase
node_storageadmin -->|"loads storage data"| node_admin
node_user -.->|"requests support"| node_support
node_support -->|"uses client"| node_supabase
node_supabase -.->|"accesses data"| node_database

click node_auth "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/auth/auth-service.ts"
click node_supabase "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/lib/supabase/client.ts"
click node_chatui "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/chat/ConversationsScreen.tsx"
click node_chatservice "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/chat/chat-service.ts"
click node_streammanager "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/chat/chat-stream-manager.ts"
click node_sse "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/lib/network/sse-transport.ts"
click node_brainui "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/brain/BrainTaskScreen.tsx"
click node_brainservice "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/brain/brain-service.ts"
click node_taskqueue "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/agent-task-scheduler/index.ts"
click node_taskworker "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/agent-task-worker/index.ts"
click node_router "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/index.ts"
click node_orchestrator "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/agent/orchestrator.ts"
click node_racing "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/racing_engine.ts"
click node_provider "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/providers/openrouter_adapter.ts"
click node_mediaui "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/media/ImageStudioScreen.tsx"
click node_mediaservice "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/media/media-service.ts"
click node_mediagateway "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/media-gateway/index.ts"
click node_imagegen "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/image-generator/index.ts"
click node_integrations "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/integrations/integration-service.ts"
click node_admin "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/admin/admin-service.ts"
click node_storageadmin "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/admin/StorageSettingsScreen.tsx"
click node_support "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/support/support-service.ts"
click node_database "https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/lib/supabase/client.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_auth,node_supabase,node_user toneBlue
class node_chatui,node_chatservice,node_streammanager,node_sse,node_brainui,node_brainservice toneAmber
class node_mediaui,node_mediaservice,node_mediagateway,node_imagegen toneMint
class node_taskqueue,node_taskworker,node_router,node_orchestrator,node_racing,node_provider toneRose
class node_integrations,node_admin,node_storageadmin,node_support,node_database toneIndigo
```

## Components

### Mobile Client

- [Authentication](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/auth/auth-service.ts): `apps/mobile/src/features/auth/auth-service.ts`
- [Supabase Client](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/lib/supabase/client.ts): `apps/mobile/src/lib/supabase/client.ts`

### Chat and Agents

- [Chat Experience](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/chat/ConversationsScreen.tsx): `apps/mobile/src/features/chat/ConversationsScreen.tsx`
- [Chat Service](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/chat/chat-service.ts): `apps/mobile/src/features/chat/chat-service.ts`
- [Stream Manager](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/chat/chat-stream-manager.ts): `apps/mobile/src/features/chat/chat-stream-manager.ts`
- [SSE Transport](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/lib/network/sse-transport.ts): `apps/mobile/src/lib/network/sse-transport.ts`
- [Agent Tasks](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/brain/BrainTaskScreen.tsx): `apps/mobile/src/features/brain/BrainTaskScreen.tsx`
- [Brain Service](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/brain/brain-service.ts): `apps/mobile/src/features/brain/brain-service.ts`

### Media Workflows

- [Media Studio](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/media/ImageStudioScreen.tsx): `apps/mobile/src/features/media/ImageStudioScreen.tsx`
- [Media Service](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/media/media-service.ts): `apps/mobile/src/features/media/media-service.ts`
- [Media Gateway](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/media-gateway/index.ts): `supabase/functions/media-gateway/index.ts`
- [Image Generation](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/image-generator/index.ts): `supabase/functions/image-generator/index.ts`

### AI Backend

- [Task Queue](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/agent-task-scheduler/index.ts): `supabase/functions/agent-task-scheduler/index.ts`
- [Task Worker](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/agent-task-worker/index.ts): `supabase/functions/agent-task-worker/index.ts`
- [AI Router](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/index.ts): `supabase/functions/ai-router/index.ts`
- [Agent Orchestrator](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/agent/orchestrator.ts): `supabase/functions/ai-router/agent/orchestrator.ts`
- [Provider Racing](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/racing_engine.ts): `supabase/functions/ai-router/racing_engine.ts`
- [Model Providers](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/supabase/functions/ai-router/providers/openrouter_adapter.ts): `supabase/functions/ai-router/providers/openrouter_adapter.ts`

### Admin and Services

- [Connected Apps](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/integrations/integration-service.ts): `apps/mobile/src/features/integrations/integration-service.ts`
- [Admin Controls](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/admin/admin-service.ts): `apps/mobile/src/features/admin/admin-service.ts`
- [Storage Browser](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/admin/StorageSettingsScreen.tsx): `apps/mobile/src/features/admin/StorageSettingsScreen.tsx`
- [Support](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/features/support/support-service.ts): `apps/mobile/src/features/support/support-service.ts`
- [Supabase Data](https://github.com/eslammohamedk123450-netizen/smsm-ai/blob/release/v1/apps/mobile/src/lib/supabase/client.ts): `apps/mobile/src/lib/supabase/client.ts`

### Other components

- **User**

## Connections

- User → Authentication: signs in (evidence: `apps/mobile/src/features/auth/auth-service.ts`)
- Authentication → Supabase Client: authenticates with (evidence: `apps/mobile/src/features/auth/auth-service.ts`)
- User → Chat Experience: submits chat
- Chat Experience → Chat Service: requests chat (evidence: `apps/mobile/src/features/chat/chat-service.ts`)
- Chat Service → Stream Manager: starts stream (evidence: `apps/mobile/src/features/chat/chat-service.ts`)
- Stream Manager → SSE Transport: streams through (evidence: `apps/mobile/src/features/chat/chat-stream-manager.ts`)
- SSE Transport → AI Router: sends requests
- User → Agent Tasks: requests task (evidence: `apps/mobile/src/features/brain/BrainTaskScreen.tsx`)
- Agent Tasks → Brain Service: runs task (evidence: `apps/mobile/src/features/brain/BrainTaskScreen.tsx`)
- Brain Service → Task Queue: enqueues task
- Task Queue → Task Worker: dispatches jobs
- Task Worker → AI Router: executes via
- AI Router → Agent Orchestrator: coordinates agents
- AI Router → Provider Racing: routes models
- Provider Racing → Model Providers: races providers (evidence: `supabase/functions/ai-router/racing_engine.ts`)
- User → Media Studio: creates media
- Media Studio → Media Service: uploads media
- Media Service → Media Gateway: requests upload (evidence: `apps/mobile/src/features/media/media-service.ts`)
- Media Studio → Image Generation: generates images
- User → Connected Apps: connects apps
- User → Admin Controls: manages platform
- Admin Controls → Supabase Client: uses client (evidence: `apps/mobile/src/features/admin/admin-service.ts`)
- Storage Browser → Admin Controls: loads storage data (evidence: `apps/mobile/src/features/admin/StorageSettingsScreen.tsx`)
- User → Support: requests support
- Support → Supabase Client: uses client (evidence: `apps/mobile/src/features/support/support-service.ts`)
- Supabase Client → Supabase Data: accesses data (evidence: `apps/mobile/src/lib/supabase/client.ts`)
