const registry = new DynamicAgentRegistry(config);
await registry.registerAgent(agentInstance);

// Internally:
// 1. Store in Map<agentId, AgentBase>
// 2. Create RegisteredAgent metadata
// 3. Persist to DynamoDB
// 4. Publish 'AgentRegistered' event
// 5. Set up status/capacity listeners
// 6. Initialize the agent

interface RegisteredAgent {
  id: string;
  name: string;
  type: string;                // "supervisor", "general-agent"
  status: 'available' | 'unavailable' | 'degraded';
  capabilities: string[];       // Array of capability IDs
  config: AgentConfig;
  capacity: {
    maxConcurrent: number;
    current: number;
  };
  metrics: {
    requestsHandled: number;
    avgResponseTime: number;
    errorRate: number;
  };
  lastHealthCheck: Date;
  responseQueue: AgentQueueMetadata;
}

// Find agents with single capability
findByCapability('scheduling'): string[]

// Find agents with ALL capabilities (intersection)
findByCapabilities(['scheduling', 'email']): string[]

// Complex search with modes
search({
  capabilities: ['travel-planning', 'booking'],
  domains: ['weather'],
  mode: 'any'  // 'any' = union, 'all' = intersection
}): string[]

// Get index statistics
getStats(): {
  totalAgents, totalCapabilities,
  totalActions, totalDomains,
  capabilityDistribution, actionDistribution
}

interface HealthStatus {
  agentId: string;
  consecutiveFailures: number;
  consecutiveSuccesses: number;
  lastCheck: HealthCheckResult;
  history: HealthCheckResult[];  // Last 10 checks
}

interface HealthCheckResult {
  agentId: string;
  healthy: boolean;
  timestamp: number;
  responseTime?: number;
  error?: string;
  details?: Record<string, any>;
}

interface HeartbeatPayload {
  agentId: string;
  agentType: string;
  status: 'healthy' | 'unhealthy' | 'degraded';
  health?: {
    status: string;
    lastCheck?: string;
    checks?: Array<{ name, status, message }>;
  };
  metrics?: Record<string, any>;
  ttlSeconds?: number;
}

// Subscribe to hot reload events
hotReloadManager.on('added', (change) => {
  console.log(`New agent: ${change.agentId}`);
});

hotReloadManager.on('updated', (change) => {
  console.log(`Updated: ${change.agentId}`);
  console.log(`Previous: ${change.previousVersion}`);
  console.log(`New: ${change.newVersion}`);
});

hotReloadManager.on('removed', (change) => {
  console.log(`Removed: ${change.agentId}`);
});

interface HotReloadChange {
  type: 'added' | 'updated' | 'removed';
  agentId: string;
  manifest?: AgentManifestContent;
  previousVersion?: string;
  newVersion?: string;
  timestamp: Date;
}

getStatus(): {
  enabled: boolean;
  isPolling: boolean;
  lastPollAt?: Date;
  lastChangeAt?: Date;
  totalAgents: number;
  pollCount: number;
  errorCount: number;
}