# BOC Agent Layer — Activation Matrix

## Inventory Date: 2026-08-12

---

## WHAT ALREADY EXISTS

### Frontend (web-v2)
| Component | Status | Location |
|-----------|--------|----------|
| AgentContext.ts | ✅ EXISTS | `web-v2/src/components/agent/AgentContext.ts` |
| AgentChat.tsx | ✅ EXISTS | `web-v2/src/components/agent/AgentChat.tsx` |
| AgentButton.tsx | ✅ EXISTS | `web-v2/src/components/agent/AgentButton.tsx` |

**Agent Definitions Found:**
- `finance` — Finance AI
- `sales` — Sales AI  
- `hr` — HR AI
- `crm` — CRM AI
- `legal` — Legal AI
- `marketing` — Marketing AI
- `dashboard` — AMOS Assistant (fallback)

**Missing Agent Definitions:**
- `accounting` — Accounting Agent
- `compliance` — Compliance Agent
- `support` — Support Agent
- `projects` — Projects Agent
- `automation` — Automation Agent
- `social` — Social Agent

### Backend (Go)
| Component | Status | Location |
|-----------|--------|----------|
| Agent API Endpoint | ❌ MISSING | No `/api/agent/*` routes |
| Agent Orchestrator | ❌ MISSING | No orchestrator service |
| Agent Handler | ❌ MISSING | No `handlers/agent.go` |

### API Endpoints (Existing Domain APIs)
| Domain | Status | Endpoints |
|--------|--------|-----------|
| CRM | ✅ OPERATIONAL | `/api/v1/crm/customers`, `/api/v1/crm/leads`, `/api/v1/crm/pipeline` |
| Sales | ✅ OPERATIONAL | `/api/v1/sales/deals`, `/api/v1/sales/mrr`, `/api/v1/sales/arr` |
| Finance | ✅ OPERATIONAL | `/api/v1/finance/balance`, `/api/v1/finance/income`, `/api/v1/finance/moms` |
| HR | ✅ OPERATIONAL | `/api/v1/hr/employees`, `/api/v1/hr/leaves`, `/api/v1/hr/timesheets` |
| Legal | ✅ OPERATIONAL | `/api/v1/legal/contracts`, `/api/v1/legal/templates` |
| Marketing | ✅ OPERATIONAL | `/api/v1/marketing/campaigns`, `/api/v1/marketing/content` |
| Support | ✅ OPERATIONAL | `/api/v1/support/tickets`, `/api/v1/support/csat` |
| Automation | ✅ OPERATIONAL | `/api/v1/automation/workflows`, `/api/v1/automation/jobs` |
| Briefing | ✅ OPERATIONAL | `/api/v1/briefing/daily`, `/api/v1/briefing/real` |

### Infrastructure
| Component | Status | Notes |
|-----------|--------|-------|
| Kubernetes Namespace | ❌ MISSING | No `boc` namespace found |
| Kubernetes Manifests | ❌ MISSING | No k8s/ directory |
| Docker Compose | ✅ EXISTS | `docker-compose.yml` |
| Backend Binary | ✅ EXISTS | `backend/boc-api` |
| Frontend Build | ✅ EXISTS | `web-v2/dist/` |

---

## WHAT WAS DISCONNECTED

1. **AgentChat.tsx** calls `/api/agent/chat` — endpoint doesn't exist
2. **AgentContext.ts** has agent definitions but no backend integration
3. **AgentButton.tsx** exists but not integrated in sidebar/layout
4. **Frontend agents** have mock responses only (fallback when API fails)

---

## WHAT WAS NOT DEPLOYED

1. **Agent API Layer** — No backend support for agent operations
2. **Agent Orchestrator** — No central routing/coordination
3. **Agent-to-Agent Communication** — No inter-agent protocol
4. **Agent Observability** — No metrics/audit for agents

---

## GAP ANALYSIS

### Critical Gaps (BLOCKING)
1. ❌ No `/api/agent/chat` endpoint
2. ❌ No agent orchestrator
3. ❌ No agent authentication/authorization
4. ❌ No agent audit trail
5. ❌ No Kubernetes deployment for agent services

### Medium Gaps
1. ❌ Missing 5 agent definitions (accounting, compliance, support, projects, automation, social)
2. ❌ Agent button not in sidebar
3. ❌ No agent status/health monitoring
4. ❌ No agent-to-agent communication protocol

### Low Gaps
1. ❌ No agent-specific observability metrics
2. ❌ No agent memory/state persistence
3. ❌ No agent tool registry

---

## IMPLEMENTATION PLAN

### Phase 1: Backend Agent API (CRITICAL)
1. Create `handlers/agent.go` — Agent chat endpoint
2. Create `service/agent/` — Agent orchestrator
3. Wire `/api/agent/chat` in `main.go`
4. Add agent authentication middleware

### Phase 2: Frontend Integration
1. Add AgentButton to sidebar
2. Create Agent Layer page
3. Connect AgentChat to real API
4. Add missing agent definitions

### Phase 3: Kubernetes Deployment
1. Create k8s namespace
2. Create deployment manifests
3. Create service/ingress
4. Deploy and verify

### Phase 4: Observability & Audit
1. Add agent metrics
2. Add audit logging
3. Add health checks
4. Add status dashboard

---

## DEFINITION OF DONE

- [ ] `/api/agent/chat` endpoint responds correctly
- [ ] All 12 agents have definitions
- [ ] Agent button visible in sidebar
- [ ] Agent chat connects to backend
- [ ] Agent responses use real domain data
- [ ] Kubernetes deployment active
- [ ] Agent audit trail working
- [ ] Agent health/status visible
- [ ] E2E test passes for each agent