graph TB
    subgraph Clients["MCP Clients"]
        Claude["Claude Code"]
        ChatGPT["ChatGPT"]
        Cursor["Cursor"]
        VSCode["VS Code"]
        Others["Any MCP Client"]
    end

    subgraph Server["Agent Memory Server"]
        direction TB
        Tools["11 Tools<br/><code>remember · recall · forget · list</code><br/><code>handoff · pickup · complete</code><br/><code>export · import · stats · cleanup</code>"]
        Resources["7 Resources<br/><code>current-context · agent-activity</code><br/><code>memory://{key} · handoff-queue · changelog</code>"]
        Prompt["1 Prompt<br/><code>session-briefing</code>"]
    end

    subgraph Storage["Persistence Layer"]
        SQLite["SQLite + WAL"]
        FTS5["FTS5 Search Engine"]
    end

    subgraph Widget["Inline Widget"]
        React["React 19 Dashboard"]
    end

    Clients -->|"MCP over SSE"| Server
    Server --> Storage
    Server --> Widget

    style Clients fill:#1e1b4b,stroke:#4f46e5,color:#e0e7ff
    style Server fill:#1a1a2e,stroke:#8b5cf6,color:#e0e7ff
    style Storage fill:#0f172a,stroke:#3b82f6,color:#e0e7ff
    style Widget fill:#0f172a,stroke:#10b981,color:#e0e7ff

sequenceDiagram
    participant A as Agent (Claude)
    participant S as Agent Memory
    participant B as Agent (ChatGPT)

    A->>S: remember("db-choice", "PostgreSQL")
    Note over S: SQLite INSERT + FTS5 index
    S-->>A: Stored + widget updates

    B->>S: recall("database")
    Note over S: FTS5 MATCH + composite scoring
    S-->>B: "PostgreSQL" (ranked result)

    A->>S: handoff(summary, context_keys)
    Note over S: Store handoff + link memories
    B->>S: pickup(handoff_id)
    Note over S: Load context + full briefing
    S-->>B: Complete project context

erDiagram
    memories ||--o{ tags : has
    memories ||--o{ memory_history : tracks
    memories }o--|| memories_fts : indexes
    activity_log }o--|| memories : references

    memories {
        int id PK
        text key UK
        text value
        text type
        text context
        text agent_id
        int access_count
        datetime created_at
        datetime updated_at
    }

    tags {
        int id PK
        int memory_id FK
        text tag
    }

    handoffs {
        int id PK
        text from_agent
        text to_agent
        text status
        text summary
        text next_steps
    }

    activity_log {
        int id PK
        text agent_id
        text action
        text target_key
        datetime created_at
    }