┌─────────────────────────────────────────────────────────────────────────┐
│                     AI AGENT WORKERS ARCHITECTURE                        │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│   Client Request                                                         │
│        │                                                                 │
│        ▼                                                                 │
│   ┌─────────────────┐                                                   │
│   │  Task Router    │                                                   │
│   │  (Orchestrator) │                                                   │
│   └────────┬────────┘                                                   │
│            │                                                             │
│   ┌────────┼────────┬────────────┬───────────┐                         │
│   ▼        ▼        ▼            ▼           ▼                         │
│ Content  Research  Automation  Analysis   Custom                        │
│  Agent    Agent     Agent       Agent     Agent                         │
│                                                                          │
│   └────────┴────────┴────────────┴───────────┘                         │
│                     │                                                    │
│                     ▼                                                    │
│            ┌─────────────────┐                                          │
│            │  Deliverables   │                                          │
│            │  & Reports      │                                          │
│            └─────────────────┘                                          │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘

Human (PM)
    │
    ├── Define task scope
    ├── Set quality criteria
    └── Approve outputs
         │
         ▼
AI Agent Worker
    │
    ├── Execute task
    ├── Self-validate
    └── Submit for review
         │
         ▼
Human (PM)
    │
    ├── Review output
    ├── Request revisions OR
    └── Approve & deliver

interface AgentOutput {
  taskId: string;
  agentType: AgentType;
  output: unknown;
  validation: {
    passed: boolean;
    checks: ValidationCheck[];
    confidence: number;
  };
  metadata: {
    tokensUsed: number;
    executionTime: number;
    model: string;
  };
}

const validateOutput = async (output: AgentOutput): Promise<boolean> => {
  const checks = [
    checkCompleteness(output),
    checkAccuracy(output),
    checkFormat(output),
    checkBrandVoice(output)
  ];

  return checks.every(check => check.passed);
};

-- Client agent configuration
CREATE TABLE agency_client_agents (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  client_id UUID REFERENCES agency_clients(id),
  agent_type TEXT NOT NULL, -- content, research, automation, analysis
  enabled BOOLEAN DEFAULT true,
  config JSONB DEFAULT '{}',
  monthly_quota INTEGER,
  used_this_month INTEGER DEFAULT 0,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

-- Agent execution logs
CREATE TABLE agency_agent_executions (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  client_id UUID REFERENCES agency_clients(id),
  agent_type TEXT NOT NULL,
  task_description TEXT,
  linear_issue_id TEXT,
  status TEXT NOT NULL, -- pending, running, completed, failed
  tokens_used INTEGER,
  cost_usd DECIMAL(10,4),
  started_at TIMESTAMPTZ,
  completed_at TIMESTAMPTZ,
  output_summary TEXT,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

-- Audit log for agent actions
SELECT
  ae.created_at,
  ae.agent_type,
  ae.task_description,
  ae.status,
  ae.tokens_used,
  ae.cost_usd
FROM agency_agent_executions ae
WHERE ae.client_id = $1
ORDER BY ae.created_at DESC
LIMIT 100;

-- Agent performance by type
SELECT
  agent_type,
  COUNT(*) as total_executions,
  AVG(tokens_used) as avg_tokens,
  AVG(EXTRACT(EPOCH FROM (completed_at - started_at))) as avg_seconds,
  COUNT(*) FILTER (WHERE status = 'completed') * 100.0 / COUNT(*) as success_rate
FROM agency_agent_executions
WHERE created_at > NOW() - INTERVAL '30 days'
GROUP BY agent_type;