boc/AGENT_ACTIVATION_MATRIX.md

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