# kandid-ai/agentsdr architecture

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

- Interactive diagram: https://gitdiagram.com/kandid-ai/agentsdr
- Repository: https://github.com/kandid-ai/agentsdr

## Overview

AgentSDR is a self-hosted sales development workspace: users find and enrich leads, reach them through email, LinkedIn, WhatsApp, or calls, then review AI-classified replies and drafts in a shared CRM. The README also documents pipeline follow-ups, analytics, and MCP access. The graph combines those documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation details are represented at subsystem level, without assuming internal call paths.

Main entry points: [`src/app/api/webhooks/message-received/route.ts`](https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/webhooks/message-received/route.ts) (LinkedIn inbound), [`src/lib/leads/schema.ts`](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/leads/schema.ts) (People and companies), [`src/lib/calls/aiCampaigns/engine.ts`](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/calls/aiCampaigns/engine.ts) (AI call campaigns), [`src/components/crm/CrmPipelineClient.tsx`](https://github.com/kandid-ai/agentsdr/blob/main/src/components/crm/CrmPipelineClient.tsx) (CRM pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and data"]
  node_lead_ui["Lead workspace<br/>[LeadsClient.tsx]"]
  node_lead_data[("People and companies<br/>[schema.ts]")]
  node_grid_ui["Enrichment tables<br/>[GridClient.tsx]"]
  node_grid_data[("Grid schema<br/>[schema.ts]")]
  node_analytics["Analytics<br/>[server.ts]"]
  node_dialog_provider["Dialog provider<br/>[DialogProvider.tsx]"]
  node_alignui_button["Button component<br/>[button.tsx]"]
  node_alignui_input["Input component<br/>[input.tsx]"]
  node_alignui_modal["Modal component<br/>[modal.tsx]"]
  node_cn["Class utility<br/>[cn.ts]"]
end

subgraph group_outreach["Lead outreach"]
  node_email_outreach["Email campaigns<br/>[route.ts]"]
  node_linkedin_outreach["LinkedIn campaigns<br/>[route.ts]"]
  node_linkedin_webhooks["LinkedIn inbound<br/>[route.ts]"]
  node_linkedin_schema[("LinkedIn data<br/>[schema.ts]")]
  node_whatsapp_outreach["WhatsApp campaigns<br/>[engine.ts]"]
  node_whatsapp_inbound["WhatsApp messages<br/>[messages.ts]"]
  node_whatsapp_schema[("WhatsApp data<br/>[schema.ts]")]
end

subgraph group_crm["AI CRM"]
  node_crm_pipeline["CRM pipeline"]
  node_crm_handlers["CRM actions<br/>[handlers.ts]"]
  node_crm_replies["AI reply handling<br/>[route.ts]"]
  node_mcp["MCP access<br/>[server.ts]"]
end

subgraph group_calling["Calling"]
  node_calling_campaigns["AI call campaigns<br/>[engine.ts]"]
  node_call_storage["Call recordings<br/>[storage.ts]"]
  node_call_worker["Call worker<br/>[main.ts]"]
end

subgraph group_platform["Platform services"]
  node_db[("Database client<br/>[db.ts]")]
  node_tenant_scope["Organization scope<br/>[scope.ts]"]
  node_linkedin_org["LinkedIn organization services"]
  node_unipile["Unipile service<br/>[unipile.service.ts]"]
  node_auth_context["Auth context<br/>[context.ts]"]
  node_channels_rules["Channel rules<br/>[rules.ts]"]
  node_webhook_inbox[("Webhook inbox<br/>[inbox.ts]")]
end

node_sales_user(("Sales user"))

node_sales_user -->|"find leads"| node_lead_ui
node_lead_ui -->|"manage records"| node_lead_data
node_sales_user -->|"enrich lists"| node_grid_ui
node_grid_ui -->|"use schema"| node_grid_data
node_lead_data -.->|"target leads"| node_email_outreach
node_lead_data -->|"target leads"| node_linkedin_outreach
node_lead_data -->|"target leads"| node_whatsapp_outreach
node_sales_user -->|"send sequences"| node_email_outreach
node_sales_user -->|"send outreach"| node_linkedin_outreach
node_sales_user -->|"send campaigns"| node_whatsapp_outreach
node_linkedin_webhooks -->|"save messages"| node_linkedin_schema
node_linkedin_webhooks -->|"record delivery"| node_webhook_inbox
node_linkedin_webhooks -->|"resolve account"| node_unipile
node_whatsapp_outreach -->|"claim sends"| node_whatsapp_schema
node_sales_user -->|"review replies"| node_crm_pipeline
node_crm_pipeline -.->|"manage actions"| node_crm_handlers
node_crm_replies -.->|"read conversations"| node_linkedin_schema
node_crm_replies -.->|"read conversations"| node_whatsapp_schema
node_crm_pipeline -->|"review drafts"| node_crm_replies
node_sales_user -->|"work by chat"| node_mcp
node_sales_user -->|"run call campaigns"| node_calling_campaigns
node_calling_campaigns -->|"check rules"| node_channels_rules
node_calling_campaigns -.->|"store recordings"| node_call_storage
node_call_worker -.->|"coordinate calls"| node_calling_campaigns
node_sales_user -->|"inspect results"| node_analytics
node_linkedin_org -->|"query accounts"| node_db
node_linkedin_org -->|"scope work"| node_tenant_scope
node_auth_context -.->|"establish organization"| node_tenant_scope
node_linkedin_webhooks -->|"gate webhook"| node_linkedin_org
node_email_outreach -.->|"persist campaigns"| node_db
node_whatsapp_inbound -->|"use message data"| node_whatsapp_schema

click node_lead_ui "https://github.com/kandid-ai/agentsdr/blob/main/src/components/leads/LeadsClient.tsx"
click node_lead_data "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/leads/schema.ts"
click node_grid_ui "https://github.com/kandid-ai/agentsdr/blob/main/src/components/grid/GridClient.tsx"
click node_grid_data "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/grid/schema.ts"
click node_analytics "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/analytics/server.ts"
click node_email_outreach "https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/outreach/campaigns/route.ts"
click node_linkedin_outreach "https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/linkedin/campaigns/route.ts"
click node_linkedin_webhooks "https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/webhooks/message-received/route.ts"
click node_linkedin_schema "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/linkedin/schema.ts"
click node_whatsapp_outreach "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/whatsapp/campaigns/engine.ts"
click node_whatsapp_inbound "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/whatsapp/messages.ts"
click node_whatsapp_schema "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/whatsapp/schema.ts"
click node_crm_pipeline "https://github.com/kandid-ai/agentsdr/blob/main/src/components/crm/CrmPipelineClient.tsx"
click node_crm_handlers "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/crm/handlers.ts"
click node_crm_replies "https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/crm/records/%5Bid%5D/draft/route.ts"
click node_mcp "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/mcp/server.ts"
click node_calling_campaigns "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/calls/aiCampaigns/engine.ts"
click node_call_storage "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/calls/storage.ts"
click node_call_worker "https://github.com/kandid-ai/agentsdr/blob/main/services/call-worker/src/main.ts"
click node_db "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/db.ts"
click node_tenant_scope "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/tenancy/scope.ts"
click node_linkedin_org "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/linkedin/organizations.server.ts"
click node_unipile "https://github.com/kandid-ai/agentsdr/blob/main/src/services/unipile.service.ts"
click node_auth_context "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/auth/context.ts"
click node_channels_rules "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/channels/rules.ts"
click node_dialog_provider "https://github.com/kandid-ai/agentsdr/blob/main/src/components/DialogProvider.tsx"
click node_alignui_button "https://github.com/kandid-ai/agentsdr/blob/main/src/components/alignui/button.tsx"
click node_alignui_input "https://github.com/kandid-ai/agentsdr/blob/main/src/components/alignui/input.tsx"
click node_alignui_modal "https://github.com/kandid-ai/agentsdr/blob/main/src/components/alignui/modal.tsx"
click node_cn "https://github.com/kandid-ai/agentsdr/blob/main/src/utils/cn.ts"
click node_webhook_inbox "https://github.com/kandid-ai/agentsdr/blob/main/src/lib/linkedin/webhooks/inbox.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_lead_ui,node_lead_data,node_grid_ui,node_grid_data,node_analytics,node_dialog_provider,node_alignui_button,node_alignui_input,node_alignui_modal,node_cn,node_sales_user toneBlue
class node_email_outreach,node_linkedin_outreach,node_linkedin_webhooks,node_linkedin_schema,node_whatsapp_outreach,node_whatsapp_inbound,node_whatsapp_schema toneAmber
class node_crm_pipeline,node_crm_handlers,node_crm_replies,node_mcp toneMint
class node_calling_campaigns,node_call_storage,node_call_worker toneRose
class node_db,node_tenant_scope,node_linkedin_org,node_unipile,node_auth_context,node_channels_rules,node_webhook_inbox toneIndigo
```

## Components

### Workspace and data

- [Lead workspace](https://github.com/kandid-ai/agentsdr/blob/main/src/components/leads/LeadsClient.tsx): `src/components/leads/LeadsClient.tsx`
- [People and companies](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/leads/schema.ts): `src/lib/leads/schema.ts`
- [Enrichment tables](https://github.com/kandid-ai/agentsdr/blob/main/src/components/grid/GridClient.tsx): `src/components/grid/GridClient.tsx`
- [Grid schema](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/grid/schema.ts): `src/lib/grid/schema.ts`
- [Analytics](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/analytics/server.ts): `src/lib/analytics/server.ts`
- [Dialog provider](https://github.com/kandid-ai/agentsdr/blob/main/src/components/DialogProvider.tsx): `src/components/DialogProvider.tsx`
- [Button component](https://github.com/kandid-ai/agentsdr/blob/main/src/components/alignui/button.tsx): `src/components/alignui/button.tsx`
- [Input component](https://github.com/kandid-ai/agentsdr/blob/main/src/components/alignui/input.tsx): `src/components/alignui/input.tsx`
- [Modal component](https://github.com/kandid-ai/agentsdr/blob/main/src/components/alignui/modal.tsx): `src/components/alignui/modal.tsx`
- [Class utility](https://github.com/kandid-ai/agentsdr/blob/main/src/utils/cn.ts): `src/utils/cn.ts`

### Lead outreach

- [Email campaigns](https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/outreach/campaigns/route.ts): `src/app/api/outreach/campaigns/route.ts`
- [LinkedIn campaigns](https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/linkedin/campaigns/route.ts): `src/app/api/linkedin/campaigns/route.ts`
- [LinkedIn inbound](https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/webhooks/message-received/route.ts): `src/app/api/webhooks/message-received/route.ts`
- [LinkedIn data](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/linkedin/schema.ts): `src/lib/linkedin/schema.ts`
- [WhatsApp campaigns](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/whatsapp/campaigns/engine.ts): `src/lib/whatsapp/campaigns/engine.ts`
- [WhatsApp messages](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/whatsapp/messages.ts): `src/lib/whatsapp/messages.ts`
- [WhatsApp data](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/whatsapp/schema.ts): `src/lib/whatsapp/schema.ts`

### AI CRM

- [CRM pipeline](https://github.com/kandid-ai/agentsdr/blob/main/src/components/crm/CrmPipelineClient.tsx): `src/components/crm/CrmPipelineClient.tsx`
- [CRM actions](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/crm/handlers.ts): `src/lib/crm/handlers.ts`
- [AI reply handling](https://github.com/kandid-ai/agentsdr/blob/main/src/app/api/crm/records/%5Bid%5D/draft/route.ts): `src/app/api/crm/records/[id]/draft/route.ts`
- [MCP access](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/mcp/server.ts): `src/lib/mcp/server.ts`

### Calling

- [AI call campaigns](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/calls/aiCampaigns/engine.ts): `src/lib/calls/aiCampaigns/engine.ts`
- [Call recordings](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/calls/storage.ts): `src/lib/calls/storage.ts`
- [Call worker](https://github.com/kandid-ai/agentsdr/blob/main/services/call-worker/src/main.ts): `services/call-worker/src/main.ts`

### Platform services

- [Database client](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Organization scope](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/tenancy/scope.ts): `src/lib/tenancy/scope.ts`
- [LinkedIn organization services](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/linkedin/organizations.server.ts): `src/lib/linkedin/organizations.server.ts`
- [Unipile service](https://github.com/kandid-ai/agentsdr/blob/main/src/services/unipile.service.ts): `src/services/unipile.service.ts`
- [Auth context](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/auth/context.ts): `src/lib/auth/context.ts`
- [Channel rules](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/channels/rules.ts): `src/lib/channels/rules.ts`
- [Webhook inbox](https://github.com/kandid-ai/agentsdr/blob/main/src/lib/linkedin/webhooks/inbox.ts): `src/lib/linkedin/webhooks/inbox.ts`

### Other components

- **Sales user**

## Connections

- Sales user → Lead workspace: find leads (evidence: `README.md`)
- Lead workspace → People and companies: manage records (evidence: `README.md`)
- Sales user → Enrichment tables: enrich lists (evidence: `README.md`)
- Enrichment tables → Grid schema: use schema (evidence: `src/components/grid/GridClient.tsx`)
- People and companies → Email campaigns: target leads
- People and companies → LinkedIn campaigns: target leads (evidence: `src/app/api/linkedin/campaigns/route.ts`)
- People and companies → WhatsApp campaigns: target leads (evidence: `src/lib/whatsapp/campaigns/engine.ts`)
- Sales user → Email campaigns: send sequences (evidence: `README.md`)
- Sales user → LinkedIn campaigns: send outreach (evidence: `README.md`)
- Sales user → WhatsApp campaigns: send campaigns (evidence: `README.md`)
- LinkedIn inbound → LinkedIn data: save messages (evidence: `src/app/api/webhooks/message-received/route.ts`)
- LinkedIn inbound → Webhook inbox: record delivery (evidence: `src/app/api/webhooks/message-received/route.ts`)
- LinkedIn inbound → Unipile service: resolve account
- WhatsApp campaigns → WhatsApp data: claim sends (evidence: `src/lib/whatsapp/campaigns/engine.ts`)
- Sales user → CRM pipeline: review replies (evidence: `README.md`)
- CRM pipeline → CRM actions: manage actions
- AI reply handling → LinkedIn data: read conversations
- AI reply handling → WhatsApp data: read conversations
- CRM pipeline → AI reply handling: review drafts (evidence: `README.md`)
- Sales user → MCP access: work by chat (evidence: `README.md`)
- Sales user → AI call campaigns: run call campaigns (evidence: `README.md`)
- AI call campaigns → Channel rules: check rules (evidence: `src/lib/calls/aiCampaigns/engine.ts`)
- AI call campaigns → Call recordings: store recordings
- Call worker → AI call campaigns: coordinate calls
- Sales user → Analytics: inspect results (evidence: `README.md`)
- LinkedIn organization services → Database client: query accounts (evidence: `src/lib/linkedin/organizations.server.ts`)
- LinkedIn organization services → Organization scope: scope work (evidence: `src/lib/linkedin/organizations.server.ts`)
- Auth context → Organization scope: establish organization
- LinkedIn inbound → LinkedIn organization services: gate webhook (evidence: `src/app/api/webhooks/message-received/route.ts`)
- Email campaigns → Database client: persist campaigns
- WhatsApp messages → WhatsApp data: use message data (evidence: `src/app/api/webhooks/whatsapp-message/route.ts`)
