# lucathesniperlc-star/mvp-eye-of-agent- architecture

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

- Interactive diagram: https://gitdiagram.com/lucathesniperlc-star/mvp-eye-of-agent-
- Repository: https://github.com/lucathesniperlc-star/mvp-eye-of-agent-

## Overview

Eyes of Agent is an enterprise AI-agent security and governance product. Users enter through the landing experience, open a tenant workspace, and review discovered agents, exposure risks, findings, policies, compliance, and integrations; workspace actions reach the API and its persistence and security services. The UI also exposes audit, enterprise administration, and connector workflows. The README is empty, so product scope is inferred from the source tree and named modules; unsampled server behavior is represented conservatively.

Main entry points: [`src/App.tsx`](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/App.tsx) (Tenant workspace), [`server/api.ts`](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/api.ts) (HTTP API), [`server/store.ts`](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/store.ts) (Tenant state store), [`server/findingsEngine.ts`](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/findingsEngine.ts) (Finding detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace UI"]
  node_landing["Product landing<br/>[LandingPage.tsx]"]
  node_app["Tenant workspace<br/>[App.tsx]"]
  node_inventory["Agent inventory<br/>[AgentInventory.tsx]"]
  node_agentdetail["Agent detail<br/>[AgentDetail.tsx]"]
  node_findingsview["Findings review<br/>[FindingsView.tsx]"]
  node_exposureview["Exposure paths<br/>[ExposurePaths.tsx]"]
  node_commandcenter["Risk command center"]
  node_allinone["Unified overview<br/>[AllInOneView.tsx]"]
  node_connectorsview["Connector management<br/>[ConnectorsView.tsx]"]
end

subgraph group_risk["Risk Analysis"]
  node_riskengine["Risk calculations<br/>[riskEngine.ts]"]
  node_findingengine["Finding detection<br/>[findingsEngine.ts]"]
  node_graphengine["Exposure traversal<br/>[graphEngine.ts]"]
  node_mockdata["Sample workspace data<br/>[mockData.ts]"]
end

subgraph group_governance["Governance Controls"]
  node_policyview["Policy management<br/>[PolicyView.tsx]"]
  node_complianceview["Compliance evidence<br/>[ComplianceView.tsx]"]
  node_auditview["Audit review<br/>[AuditLogView.tsx]"]
  node_enterpriseview["Enterprise administration<br/>[EnterpriseView.tsx]"]
end

subgraph group_services["Server Services"]
  node_api["HTTP API<br/>[api.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_connectors["Connector registry"]
  node_governanceengine["Governance engine"]
  node_enterpriseengine["Enterprise engine"]
  node_vault["Credential vault<br/>[cryptoVault.ts]"]
  node_store[("Tenant state store<br/>[store.ts]")]
end

node_user(("Security user"))

node_user -->|"opens"| node_landing
node_landing -->|"launches demo"| node_app
node_user -->|"uses workspace"| node_app
node_app -->|"renders"| node_inventory
node_app -->|"renders"| node_agentdetail
node_app -->|"renders"| node_findingsview
node_app -->|"renders"| node_exposureview
node_app -->|"renders"| node_commandcenter
node_app -->|"renders"| node_allinone
node_app -->|"renders"| node_connectorsview
node_app -->|"renders"| node_policyview
node_app -->|"renders"| node_complianceview
node_app -->|"renders"| node_auditview
node_app -->|"renders"| node_enterpriseview
node_app -->|"requests data"| node_api
node_inventory -->|"calculates risk"| node_riskengine
node_exposureview -->|"computes paths"| node_riskengine
node_findingsview -.->|"loads findings"| node_findingengine
node_app -->|"loads workspace data"| node_mockdata
node_api -->|"delegates auth"| node_auth
node_api -->|"dispatches connector actions"| node_connectors
node_api -->|"uses credentials"| node_vault
node_api -->|"reads and updates"| node_store
node_connectors -->|"encrypts credentials"| node_vault
node_connectors -->|"generates findings"| node_findingengine
node_findingengine -->|"traverses exposure"| node_graphengine
node_enterpriseengine -->|"classifies content"| node_governanceengine
node_governanceengine -->|"redacts sensitive fields"| node_vault
node_store -->|"seeds workspace"| node_mockdata
node_store -.->|"uses detection logic"| node_findingengine
node_store -.->|"uses governance logic"| node_governanceengine
node_store -.->|"uses enterprise logic"| node_enterpriseengine

click node_landing "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/LandingPage.tsx"
click node_app "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/App.tsx"
click node_inventory "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/AgentInventory.tsx"
click node_agentdetail "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/AgentDetail.tsx"
click node_findingsview "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/FindingsView.tsx"
click node_exposureview "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/ExposurePaths.tsx"
click node_commandcenter "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/RiskCommandCenter.tsx"
click node_allinone "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/AllInOneView.tsx"
click node_connectorsview "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/ConnectorsView.tsx"
click node_policyview "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/PolicyView.tsx"
click node_complianceview "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/ComplianceView.tsx"
click node_auditview "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/AuditLogView.tsx"
click node_enterpriseview "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/EnterpriseView.tsx"
click node_riskengine "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/utils/riskEngine.ts"
click node_findingengine "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/findingsEngine.ts"
click node_graphengine "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/graphEngine.ts"
click node_api "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/api.ts"
click node_auth "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/auth.ts"
click node_connectors "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/connectorRegistry.ts"
click node_governanceengine "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/governanceEngine.ts"
click node_enterpriseengine "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/enterpriseEngine.ts"
click node_vault "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/cryptoVault.ts"
click node_store "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/store.ts"
click node_mockdata "https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/data/mockData.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_landing,node_app,node_inventory,node_agentdetail,node_findingsview,node_exposureview,node_commandcenter,node_allinone,node_connectorsview,node_user toneBlue
class node_riskengine,node_findingengine,node_graphengine,node_mockdata toneAmber
class node_policyview,node_complianceview,node_auditview,node_enterpriseview toneMint
class node_api,node_auth,node_connectors,node_governanceengine,node_enterpriseengine,node_vault,node_store toneRose
```

## Components

### Workspace UI

- [Product landing](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/LandingPage.tsx): `src/components/LandingPage.tsx`
- [Tenant workspace](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/App.tsx): `src/App.tsx`
- [Agent inventory](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/AgentInventory.tsx): `src/components/AgentInventory.tsx`
- [Agent detail](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/AgentDetail.tsx): `src/components/AgentDetail.tsx`
- [Findings review](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/FindingsView.tsx): `src/components/FindingsView.tsx`
- [Exposure paths](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/ExposurePaths.tsx): `src/components/ExposurePaths.tsx`
- [Risk command center](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/RiskCommandCenter.tsx): `src/components/RiskCommandCenter.tsx`
- [Unified overview](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/AllInOneView.tsx): `src/components/AllInOneView.tsx`
- [Connector management](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/ConnectorsView.tsx): `src/components/ConnectorsView.tsx`

### Risk Analysis

- [Risk calculations](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/utils/riskEngine.ts): `src/utils/riskEngine.ts`
- [Finding detection](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/findingsEngine.ts): `server/findingsEngine.ts`
- [Exposure traversal](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/graphEngine.ts): `server/graphEngine.ts`
- [Sample workspace data](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/data/mockData.ts): `src/data/mockData.ts`

### Governance Controls

- [Policy management](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/PolicyView.tsx): `src/components/PolicyView.tsx`
- [Compliance evidence](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/ComplianceView.tsx): `src/components/ComplianceView.tsx`
- [Audit review](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/AuditLogView.tsx): `src/components/AuditLogView.tsx`
- [Enterprise administration](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/src/components/EnterpriseView.tsx): `src/components/EnterpriseView.tsx`

### Server Services

- [HTTP API](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/api.ts): `server/api.ts`
- [Authentication](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/auth.ts): `server/auth.ts`
- [Connector registry](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/connectorRegistry.ts): `server/connectorRegistry.ts`
- [Governance engine](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/governanceEngine.ts): `server/governanceEngine.ts`
- [Enterprise engine](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/enterpriseEngine.ts): `server/enterpriseEngine.ts`
- [Credential vault](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/cryptoVault.ts): `server/cryptoVault.ts`
- [Tenant state store](https://github.com/lucathesniperlc-star/mvp-eye-of-agent-/blob/main/server/store.ts): `server/store.ts`

### Other components

- **Security user**

## Connections

- Security user → Product landing: opens
- Product landing → Tenant workspace: launches demo (evidence: `src/App.tsx`)
- Security user → Tenant workspace: uses workspace (evidence: `src/App.tsx`)
- Tenant workspace → Agent inventory: renders (evidence: `src/App.tsx`)
- Tenant workspace → Agent detail: renders (evidence: `src/App.tsx`)
- Tenant workspace → Findings review: renders (evidence: `src/App.tsx`)
- Tenant workspace → Exposure paths: renders (evidence: `src/App.tsx`)
- Tenant workspace → Risk command center: renders (evidence: `src/App.tsx`)
- Tenant workspace → Unified overview: renders (evidence: `src/App.tsx`)
- Tenant workspace → Connector management: renders (evidence: `src/App.tsx`)
- Tenant workspace → Policy management: renders (evidence: `src/App.tsx`)
- Tenant workspace → Compliance evidence: renders (evidence: `src/App.tsx`)
- Tenant workspace → Audit review: renders (evidence: `src/App.tsx`)
- Tenant workspace → Enterprise administration: renders (evidence: `src/App.tsx`)
- Tenant workspace → HTTP API: requests data (evidence: `src/App.tsx`)
- Agent inventory → Risk calculations: calculates risk (evidence: `src/components/AgentInventory.tsx`)
- Exposure paths → Risk calculations: computes paths (evidence: `src/components/ExposurePaths.tsx`)
- Findings review → Finding detection: loads findings
- Tenant workspace → Sample workspace data: loads workspace data (evidence: `src/App.tsx`)
- HTTP API → Authentication: delegates auth (evidence: `server/api.ts`)
- HTTP API → Connector registry: dispatches connector actions (evidence: `server/api.ts`)
- HTTP API → Credential vault: uses credentials (evidence: `server/api.ts`)
- HTTP API → Tenant state store: reads and updates (evidence: `server/api.ts`)
- Connector registry → Credential vault: encrypts credentials (evidence: `server/connectorRegistry.ts`)
- Connector registry → Finding detection: generates findings (evidence: `server/connectorRegistry.ts`)
- Finding detection → Exposure traversal: traverses exposure (evidence: `server/findingsEngine.ts`)
- Enterprise engine → Governance engine: classifies content (evidence: `server/enterpriseEngine.ts`)
- Governance engine → Credential vault: redacts sensitive fields (evidence: `server/governanceEngine.ts`)
- Tenant state store → Sample workspace data: seeds workspace (evidence: `server/store.ts`)
- Tenant state store → Finding detection: uses detection logic (evidence: `server/store.ts`)
- Tenant state store → Governance engine: uses governance logic (evidence: `server/store.ts`)
- Tenant state store → Enterprise engine: uses enterprise logic (evidence: `server/store.ts`)
