@agenticmail/enterprise 0.5.327 → 0.5.329

package/src/engine/routes.ts

@@ -1,1236 +0,0 @@
-/**
- * Engine API Routes — Orchestrator
- *
- * Mounts domain-specific sub-routers on the engine Hono app.
- * Mounted at /api/engine/* on the enterprise server.
- *
- * Sub-apps handle domain-specific route groups:
- *   - dlp-routes.ts           → /dlp/*
- *   - guardrail-routes.ts     → /guardrails/*, /anomaly-rules/*
- *   - journal-routes.ts       → /journal/*
- *   - communication-routes.ts → /messages/*, /tasks/*
- *   - compliance-routes.ts    → /compliance/*
- *   - catalog-routes.ts       → /skills/*, /souls/*, /profiles/*, /permissions/*, /config/*
- *   - agent-routes.ts         → /agents/*, /usage/*, /budget/*, /bridge/*
- *   - knowledge-routes.ts     → /knowledge-bases/*
- *   - org-approval-routes.ts  → /orgs/*, /approvals/*, /escalation-chains/*
- *   - activity-routes.ts      → /activity/*, /stats/*
- *   - deploy-schema-routes.ts → /deploy-credentials/*, /schema/*
- *   - community-routes.ts    → /community/*
- *   - workforce-routes.ts    → /workforce/*
- *   - policy-routes.ts       → /policies/*
- *   - memory-routes.ts       → /memory/*
- *   - onboarding-routes.ts   → /onboarding/*
- *   - vault-routes.ts        → /vault/*
- *   - storage-routes.ts      → /storage/*
- *   - policy-import-routes.ts→ /policies/import/*
- */
-
-import { Hono } from 'hono';
-import type { AppEnv } from '../types/hono-env.js';
-import { PermissionEngine, BUILTIN_SKILLS, PRESET_PROFILES, SKILL_SUITES } from './skills.js';
-import { FULL_SKILL_DEFINITIONS } from './skills/index.js';
-import { AgentConfigGenerator } from './agent-config.js';
-import { DeploymentEngine } from './deployer.js';
-import { ApprovalEngine } from './approvals.js';
-import { AgentLifecycleManager } from './lifecycle.js';
-import { KnowledgeBaseEngine } from './knowledge.js';
-import { TenantManager } from './tenant.js';
-import { ActivityTracker } from './activity.js';
-import { DLPEngine } from './dlp.js';
-import { AgentCommunicationBus } from './communication.js';
-import { GuardrailEngine } from './guardrails.js';
-import { ActionJournal } from './journal.js';
-import { ComplianceReporter } from './compliance.js';
-import {
-  getSoulTemplates,
-  getSoulTemplatesByCategory,
-  getSoulTemplate,
-  searchSoulTemplates,
-  SOUL_CATEGORIES,
-} from './soul-library.js';
-import { createDlpRoutes } from './dlp-routes.js';
-import { createGuardrailRoutes, createAnomalyRoutes } from './guardrail-routes.js';
-import { createJournalRoutes } from './journal-routes.js';
-import { createCommunicationRoutes, createTaskRoutes } from './communication-routes.js';
-import { createComplianceRoutes } from './compliance-routes.js';
-import { createCatalogRoutes } from './catalog-routes.js';
-import { createAgentRoutes } from './agent-routes.js';
-import { createKnowledgeRoutes } from './knowledge-routes.js';
-import { createOrgApprovalRoutes } from './org-approval-routes.js';
-import { createActivityRoutes } from './activity-routes.js';
-import { createDeploySchemaRoutes } from './deploy-schema-routes.js';
-import { CommunitySkillRegistry } from './community-registry.js';
-import { createCommunityRoutes } from './community-routes.js';
-import { WorkforceManager } from './workforce.js';
-import { createWorkforceRoutes } from './workforce-routes.js';
-import { OrgPolicyEngine } from './org-policies.js';
-import { AgentMemoryManager } from './agent-memory.js';
-import { OnboardingManager } from './onboarding.js';
-import { createPolicyRoutes } from './policy-routes.js';
-import { KnowledgeContributionManager } from './knowledge-contribution.js';
-import { createKnowledgeContributionRoutes } from './knowledge-contribution-routes.js';
-import { SkillAutoUpdater } from './skill-updater.js';
-import { createSkillUpdaterRoutes } from './skill-updater-routes.js';
-import { KnowledgeImportManager, createKnowledgeImportRoutes } from './knowledge-import/index.js';
-import { createMemoryRoutes } from './memory-routes.js';
-import { createMemoryTransferRoutes } from './memory-transfer-routes.js';
-import { createOnboardingRoutes } from './onboarding-routes.js';
-import { SecureVault } from './vault.js';
-import { StorageManager } from './storage-manager.js';
-import { PolicyImporter } from './policy-import.js';
-import { createVaultRoutes } from './vault-routes.js';
-import { createStorageRoutes } from './storage-routes.js';
-import { createPolicyImportRoutes } from './policy-import-routes.js';
-import { createOAuthConnectRoutes } from './oauth-connect-routes.js';
-import { OrgIntegrationManager } from './org-integrations.js';
-import { createOrgIntegrationRoutes } from './org-integration-routes.js';
-import { createChatWebhookRoutes } from './chat-webhook-routes.js';
-import { ChatPoller } from './chat-poller.js';
-import { EmailPoller } from './email-poller.js';
-import { MessagingPoller } from './messaging-poller.js';
-import { TaskQueueManager } from './task-queue.js';
-import { createTaskQueueRoutes } from './task-queue-routes.js';
-import type { DatabaseAdapter } from '../db/adapter.js';
-
-const engine = new Hono<AppEnv>();
-let _engineApp: Hono<AppEnv> = engine;
-
-// Forward declarations (set later via setEngineDb)
-let _engineDb: import('./db-adapter.js').EngineDatabase | null = null;
-let _adminDb: DatabaseAdapter | null = null;
-
-// ─── Shared Instances ───────────────────────────────────
-
-const permissionEngine = new PermissionEngine(FULL_SKILL_DEFINITIONS);
-{
-  const totalTools = FULL_SKILL_DEFINITIONS.reduce((s, sk) => s + sk.tools.length, 0);
-  console.log(`[permissions] Registered ${FULL_SKILL_DEFINITIONS.length} skills, ${totalTools} tools`);
-}
-const configGen = new AgentConfigGenerator();
-const deployer = new DeploymentEngine();
-const approvals = new ApprovalEngine();
-const lifecycle = new AgentLifecycleManager({ permissions: permissionEngine });
-const knowledgeBase = new KnowledgeBaseEngine();
-const tenants = new TenantManager();
-const activity = new ActivityTracker();
-import { AgentStatusTracker } from './agent-status.js';
-const agentStatus = new AgentStatusTracker();
-import { ClusterManager } from './cluster.js';
-const cluster = new ClusterManager();
-const dlp = new DLPEngine();
-const commBus = new AgentCommunicationBus();
-const guardrails = new GuardrailEngine({
-  stopAgent: async (agentId, by, reason) => { await lifecycle.stop(agentId, by, reason); },
-});
-const journal = new ActionJournal();
-const compliance = new ComplianceReporter();
-const communityRegistry = new CommunitySkillRegistry({ permissions: permissionEngine });
-const workforce = new WorkforceManager({ lifecycle, guardrails });
-const policyEngine = new OrgPolicyEngine();
-const memoryManager = new AgentMemoryManager();
-const onboarding = new OnboardingManager({ policyEngine, memoryManager });
-const vault = new SecureVault();
-const orgIntegrations = new OrgIntegrationManager();
-orgIntegrations.setVault(vault);
-const storageManager = new StorageManager({ vault });
-const policyImporter = new PolicyImporter({ policyEngine, storageManager });
-const knowledgeContribution = new KnowledgeContributionManager({ memoryCallback: async (agentId: string) => memoryManager.queryMemories({ agentId }) });
-
-// Agent hierarchy manager (org chart, delegation, escalation)
-import { AgentHierarchyManager } from './agent-hierarchy.js';
-let hierarchyManager: AgentHierarchyManager | null = null;
-const knowledgeImport = new KnowledgeImportManager({ knowledgeContribution });
-const taskQueue = new TaskQueueManager();
-const skillUpdater = new SkillAutoUpdater({ registry: communityRegistry });
-
-// Wire onboarding into guardrails for onboarding gate checks
-guardrails.setOnboardingManager(onboarding);
-
-// Wire lifecycle events into activity tracker
-lifecycle.onEvent((event) => {
-  activity.record({
-    agentId: event.agentId,
-    orgId: event.orgId,
-    type: event.type as any,
-    data: event.data,
-  });
-});
-
-// Wire lifecycle into communication bus for agent email registry
-commBus.setLifecycle(lifecycle);
-
-// Wire birthday automation — sends a birthday email to each agent on their DOB
-lifecycle.setBirthdaySender(async (agent) => {
-  const dob = agent.config?.identity?.dateOfBirth;
-  if (!dob) return;
-  const age = AgentConfigGenerator.deriveAge(dob);
-  const name = agent.config.displayName || agent.config.name;
-  const ordinal = age % 10 === 1 && age !== 11 ? 'st' : age % 10 === 2 && age !== 12 ? 'nd' : age % 10 === 3 && age !== 13 ? 'rd' : 'th';
-  await commBus.sendMessage({
-    orgId: agent.orgId,
-    fromAgentId: 'system',
-    toAgentId: agent.id,
-    subject: `Happy Birthday, ${name}!`,
-    content: `Happy ${age}${ordinal} birthday, ${name}! Wishing you a wonderful day full of great conversations and accomplishments. Here's to another year of excellence!`,
-    priority: 'normal',
-    metadata: { type: 'birthday', age, dateOfBirth: dob },
-  });
-});
-lifecycle.startBirthdayScheduler();
-
-// ─── Transport Encryption ───────────────────────────────
-import { transportEncryptionMiddleware, setTransportEncryptionConfig, getConfig as getTransportEncConfig, loadConfig as loadTransportEncConfig, setSettingsDb as setTransportEncSettingsDb } from '../middleware/transport-encryption.js';
-engine.use('*', transportEncryptionMiddleware());
-
-// Client key exchange endpoint (returns derived key token for dashboard)
-engine.get('/transport-encryption/client-key', async (c) => {
-  const cfg = getTransportEncConfig();
-  if (!cfg.enabled) return c.json({ enabled: false });
-  // Generate a session-scoped key token derived from the server key
-  // The client uses this to derive the same encryption/hmac keys
-  const baseKey = process.env.TRANSPORT_ENCRYPTION_KEY || process.env.ENCRYPTION_KEY || process.env.JWT_SECRET || 'agenticmail-transport-default-key';
-  const { createHash } = await import('node:crypto');
-  const suffix = 'agenticmail-transport-v1';
-  const keyToken = createHash('sha256').update(`${baseKey}:${suffix}`).digest('hex');
-  return c.json({ enabled: true, keyToken });
-});
-
-engine.get('/transport-encryption/config', (c) => c.json(getTransportEncConfig()));
-engine.put('/transport-encryption/config', async (c) => {
-  const body = await c.req.json();
-  setTransportEncryptionConfig(body);
-  return c.json({ success: true });
-});
-
-// ─── Auth Context Extraction ────────────────────────────
-// When engine routes are called via the server proxy, auth context
-// is forwarded as custom headers. Extract into Hono context.
-engine.use('*', async (c, next) => {
-  const userId = c.req.header('X-User-Id');
-  const userRole = c.req.header('X-User-Role');
-  const authType = c.req.header('X-Auth-Type');
-  const requestId = c.req.header('X-Request-Id');
-  if (userId) c.set('userId', userId);
-  if (userRole) c.set('userRole', userRole);
-  if (authType) c.set('authType', authType);
-  if (requestId) c.set('requestId', requestId);
-  await next();
-});
-
-// ─── Mount Sub-Apps ─────────────────────────────────────
-
-engine.route('/dlp', createDlpRoutes(dlp));
-engine.route('/guardrails', createGuardrailRoutes(guardrails, {
-  getWorkforceOffDuty: (agentId) => workforce.isOffDuty(agentId),
-}));
-engine.route('/anomaly-rules', createAnomalyRoutes(guardrails));
-engine.route('/journal', createJournalRoutes(journal));
-engine.route('/messages', createCommunicationRoutes(commBus));
-engine.route('/tasks', createTaskRoutes(commBus));
-engine.route('/task-pipeline', createTaskQueueRoutes(taskQueue));
-engine.route('/compliance', createComplianceRoutes(compliance));
-
-engine.route('/', createCatalogRoutes({
-  skills: BUILTIN_SKILLS,
-  presets: PRESET_PROFILES,
-  permissions: permissionEngine,
-  configGen,
-  soulLib: { getSoulTemplates, getSoulTemplatesByCategory, getSoulTemplate, searchSoulTemplates, SOUL_CATEGORIES },
-  suites: SKILL_SUITES,
-  lifecycle,
-}));
-
-engine.route('/', createAgentRoutes({
-  lifecycle,
-  permissions: permissionEngine,
-  getAdminDb: () => _adminDb,
-  get engineDb() { return _engineDb; },
-}));
-
-engine.route('/', createKnowledgeRoutes(knowledgeBase));
-
-engine.route('/', createOrgApprovalRoutes({
-  tenants,
-  approvals,
-}));
-
-engine.route('/', createActivityRoutes({
-  activity,
-  tenants,
-  lifecycle,
-}));
-
-engine.route('/', createDeploySchemaRoutes(() => _engineDb, () => vault));
-
-// ─── Real-Time Agent Status ───────────────────────────
-engine.get('/agent-status', (c) => {
-  return c.json({ statuses: agentStatus.getAllStatuses() });
-});
-
-engine.get('/agent-status/:agentId', (c) => {
-  return c.json(agentStatus.getStatus(c.req.param('agentId')));
-});
-
-// Agents POST their status here (internal API, no auth needed for agent-to-server)
-engine.post('/agent-status/:agentId', async (c) => {
-  try {
-    const body = await c.req.json();
-    agentStatus.externalUpdate(c.req.param('agentId'), body);
-    return c.json({ ok: true });
-  } catch (err: any) { return c.json({ error: err.message }, 400); }
-});
-
-engine.get('/agent-status-stream', (c) => {
-  const filterAgent = c.req.query('agentId');
-  const stream = new ReadableStream({
-    start(controller) {
-      const encoder = new TextEncoder();
-      const send = (data: string) => {
-        try { controller.enqueue(encoder.encode(`data: ${data}\n\n`)); }
-        catch { unsub(); }
-      };
-
-      // Send current state immediately
-      if (filterAgent) {
-        send(JSON.stringify({ type: 'status', ...agentStatus.getStatus(filterAgent) }));
-      } else {
-        for (const s of agentStatus.getAllStatuses()) {
-          send(JSON.stringify({ type: 'status', ...s }));
-        }
-      }
-
-      // Subscribe to updates
-      const unsub = agentStatus.subscribe((agentId, snapshot) => {
-        if (filterAgent && agentId !== filterAgent) return;
-        send(JSON.stringify({ type: 'status', ...snapshot }));
-      });
-
-      // Keepalive
-      const hb = setInterval(() => send(JSON.stringify({ type: 'heartbeat' })), 30_000);
-
-      c.req.raw.signal.addEventListener('abort', () => { unsub(); clearInterval(hb); });
-    },
-  });
-  return new Response(stream, {
-    headers: { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', 'Connection': 'keep-alive' },
-  });
-});
-
-// ─── Cluster Management ─────────────────────────────────
-engine.get('/cluster/nodes', (c) => c.json({ nodes: cluster.getAllNodes(), stats: cluster.getStats() }));
-engine.get('/cluster/nodes/:nodeId', (c) => {
-  const node = cluster.getNode(c.req.param('nodeId'));
-  return node ? c.json(node) : c.json({ error: 'Node not found' }, 404);
-});
-engine.post('/cluster/register', async (c) => {
-  const body = await c.req.json();
-  if (!body.nodeId || !body.host || !body.port) return c.json({ error: 'nodeId, host, port required' }, 400);
-  const node = await cluster.register(body);
-  return c.json(node);
-});
-engine.post('/cluster/heartbeat/:nodeId', async (c) => {
-  const body = await c.req.json().catch(() => ({}));
-  cluster.heartbeat(c.req.param('nodeId'), body);
-  return c.json({ ok: true });
-});
-engine.delete('/cluster/nodes/:nodeId', async (c) => {
-  await cluster.remove(c.req.param('nodeId'));
-  return c.json({ removed: true });
-});
-engine.get('/cluster/best-node', (c) => {
-  const caps = c.req.query('capabilities')?.split(',').filter(Boolean);
-  const node = cluster.findBestNode(caps);
-  return node ? c.json(node) : c.json({ error: 'No suitable node available' }, 404);
-});
-engine.post('/cluster/test-connection', async (c) => {
-  const { host, port } = await c.req.json();
-  if (!host) return c.json({ error: 'host required' }, 400);
-  const p = port || 3101;
-  const start = Date.now();
-  try {
-    const ctrl = new AbortController();
-    const timeout = setTimeout(() => ctrl.abort(), 5000);
-    const res = await fetch(`http://${host}:${p}/health`, { signal: ctrl.signal }).catch(() => null);
-    clearTimeout(timeout);
-    if (res && res.ok) {
-      const data = await res.json().catch(() => ({}));
-      return c.json({ success: true, latencyMs: Date.now() - start, version: data.version, agentId: data.agentId });
-    }
-    // Try the enterprise status endpoint as fallback
-    const ctrl2 = new AbortController();
-    const timeout2 = setTimeout(() => ctrl2.abort(), 5000);
-    const res2 = await fetch(`http://${host}:${p}/api/status`, { signal: ctrl2.signal }).catch(() => null);
-    clearTimeout(timeout2);
-    if (res2 && res2.ok) {
-      return c.json({ success: true, latencyMs: Date.now() - start, version: 'enterprise' });
-    }
-    return c.json({ success: false, error: 'No response from ' + host + ':' + p, latencyMs: Date.now() - start });
-  } catch (e: any) {
-    return c.json({ success: false, error: e.message || 'Connection failed', latencyMs: Date.now() - start });
-  }
-});
-
-engine.post('/cluster/deploy-via-ssh', async (c) => {
-  const body = await c.req.json();
-  if (!body.host) return c.json({ error: 'host required' }, 400);
-  // Use the deployment engine's SSH infrastructure
-  try {
-    const dbUrl = process.env.DATABASE_URL || '';
-    const enterpriseUrl = process.env.ENTERPRISE_URL || `http://${body.host}:${body.port || 3101}`;
-    const nodeId = body.name?.toLowerCase().replace(/[^a-z0-9-]/g, '-') || 'worker-' + body.host.replace(/\./g, '-');
-
-    // Build remote setup script
-    const script = [
-      '#!/bin/bash',
-      'set -e',
-      'export NVM_DIR="$HOME/.nvm"',
-      '[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"',
-      '',
-      '# Install Node.js if not present',
-      'if ! command -v node &> /dev/null; then',
-      '  if command -v apt-get &> /dev/null; then',
-      '    curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -',
-      '    sudo apt-get install -y nodejs',
-      '  elif command -v brew &> /dev/null; then',
-      '    brew install node',
-      '  fi',
-      'fi',
-      '',
-      '# Install PM2 and AgenticMail',
-      'npm install -g pm2 @agenticmail/enterprise',
-      '',
-      '# Write env file',
-      'mkdir -p ~/.agenticmail',
-      `cat > ~/.agenticmail/worker.env << 'ENVEOF'`,
-      `ENTERPRISE_URL=${enterpriseUrl}`,
-      `WORKER_NODE_ID=${nodeId}`,
-      `WORKER_NAME="${body.name || nodeId}"`,
-      `DATABASE_URL=${dbUrl}`,
-      `PORT=${body.port || 3101}`,
-      'LOG_LEVEL=warn',
-      'ENVEOF',
-      '',
-      '# Start agents via PM2',
-      ...(body.agentIds || []).map((id: string, i: number) =>
-        `pm2 start "$(which agenticmail-enterprise || echo npx @agenticmail/enterprise) agent --id ${id}" --name "agent-${i}" --env ~/.agenticmail/worker.env`
-      ),
-      'pm2 save',
-      'echo "DEPLOY_SUCCESS"',
-    ].join('\n');
-
-    const { execSync } = await import('child_process');
-    const sshTarget = `${body.user || 'root'}@${body.host}`;
-    const keyOpt = body.privateKey ? `-i /tmp/_am_ssh_key_${Date.now()}` : '';
-
-    if (body.privateKey) {
-      const { writeFileSync, chmodSync } = await import('fs');
-      const keyPath = `/tmp/_am_ssh_key_${Date.now()}`;
-      writeFileSync(keyPath, body.privateKey, { mode: 0o600 });
-    }
-
-    const scriptB64 = Buffer.from(script).toString('base64');
-    const sshCmd = `ssh -o StrictHostKeyChecking=no -o ConnectTimeout=10 ${keyOpt} ${sshTarget} "echo '${scriptB64}' | base64 -d | bash"`;
-
-    // Run async — don't block the request
-    const { exec } = await import('child_process');
-    exec(sshCmd, { timeout: 120_000 }, (err, stdout, _stderr) => {
-      if (err) {
-        console.warn(`[cluster] SSH deploy to ${body.host} failed:`, err.message);
-      } else if (stdout.includes('DEPLOY_SUCCESS')) {
-        console.log(`[cluster] SSH deploy to ${body.host} succeeded`);
-      }
-    });
-
-    return c.json({ message: 'Deployment started via SSH to ' + sshTarget + '. Check the Cluster page for the node to appear.', nodeId });
-  } catch (e: any) {
-    return c.json({ error: 'SSH deploy failed: ' + e.message }, 500);
-  }
-});
-
-engine.post('/cluster/nodes/:nodeId/restart', async (c) => {
-  const node = cluster.getNode(c.req.param('nodeId'));
-  if (!node) return c.json({ error: 'Node not found' }, 404);
-  try {
-    const ctrl = new AbortController();
-    setTimeout(() => ctrl.abort(), 10000);
-    await fetch(`${node.url}/restart`, { method: 'POST', signal: ctrl.signal }).catch(() => {});
-    return c.json({ ok: true, message: 'Restart signal sent to ' + node.name });
-  } catch (e: any) {
-    return c.json({ error: e.message }, 500);
-  }
-});
-
-engine.get('/cluster/stream', (c) => {
-  const stream = new ReadableStream({
-    start(controller) {
-      const encoder = new TextEncoder();
-      const send = (d: string) => { try { controller.enqueue(encoder.encode(`data: ${d}\n\n`)); } catch { unsub(); } };
-      // Send current state
-      for (const n of cluster.getAllNodes()) send(JSON.stringify({ type: 'node', event: 'snapshot', ...n }));
-      const unsub = cluster.subscribe((_nodeId, node, event) => send(JSON.stringify({ type: 'node', event, ...node })));
-      const hb = setInterval(() => send(JSON.stringify({ type: 'heartbeat' })), 30_000);
-      c.req.raw.signal.addEventListener('abort', () => { unsub(); clearInterval(hb); });
-    },
-  });
-  return new Response(stream, { headers: { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', 'Connection': 'keep-alive' } });
-});
-
-engine.route('/community', createCommunityRoutes(communityRegistry));
-engine.route('/workforce', createWorkforceRoutes(workforce, { lifecycle }));
-engine.route('/policies', createPolicyRoutes(policyEngine));
-engine.route('/memory', createMemoryRoutes(memoryManager));
-engine.route('/memory-transfer', createMemoryTransferRoutes(memoryManager, _engineDb));
-engine.route('/onboarding', createOnboardingRoutes(onboarding));
-engine.route('/vault', createVaultRoutes(vault, dlp));
-engine.route('/storage', createStorageRoutes(storageManager));
-engine.route('/policies', createPolicyImportRoutes(policyImporter));
-engine.route('/knowledge-contribution', createKnowledgeContributionRoutes(knowledgeContribution, { lifecycle }));
-engine.route('/knowledge-import', createKnowledgeImportRoutes(knowledgeImport));
-engine.route('/skill-updates', createSkillUpdaterRoutes(skillUpdater));
-engine.route('/oauth', createOAuthConnectRoutes(vault, lifecycle, () => _adminDb));
-engine.route('/org-integrations', createOrgIntegrationRoutes(orgIntegrations));
-
-// Database Access system
-import { DatabaseConnectionManager, createDatabaseAccessRoutes } from '../database-access/index.js';
-const databaseManager = new DatabaseConnectionManager({ vault });
-engine.route('/database', createDatabaseAccessRoutes(databaseManager));
-
-// ─── Hierarchy / Management API ─────────────────────────
-engine.get('/hierarchy/org-chart', async (c) => {
-  if (!hierarchyManager) return c.json({ error: 'Hierarchy not initialized' }, 503);
-  try {
-    const chart = await hierarchyManager.buildOrgChart();
-    const nodes = await hierarchyManager.buildHierarchy();
-    return c.json({ chart, nodes: Array.from(nodes.values()) });
-  } catch (e: any) {
-    return c.json({ error: e.message }, 500);
-  }
-});
-
-engine.get('/hierarchy/team/:managerId', async (c) => {
-  if (!hierarchyManager) return c.json({ error: 'Hierarchy not initialized' }, 503);
-  try {
-    const status = await hierarchyManager.getTeamStatus(c.req.param('managerId'));
-    return c.json(status);
-  } catch (e: any) {
-    return c.json({ error: e.message }, 500);
-  }
-});
-
-engine.get('/hierarchy/tasks/:agentId', async (c) => {
-  if (!hierarchyManager) return c.json({ error: 'Hierarchy not initialized' }, 503);
-  try {
-    const status = c.req.query('status');
-    const direction = c.req.query('direction') || 'assigned'; // assigned | delegated
-    const tasks = direction === 'delegated'
-      ? await hierarchyManager.getTasksByManager(c.req.param('agentId'), status || undefined)
-      : await hierarchyManager.getTasksForAgent(c.req.param('agentId'), status || undefined);
-    return c.json({ tasks });
-  } catch (e: any) {
-    return c.json({ error: e.message }, 500);
-  }
-});
-
-engine.get('/hierarchy/escalations/:agentId', async (c) => {
-  if (!hierarchyManager) return c.json({ error: 'Hierarchy not initialized' }, 503);
-  try {
-    const escalations = await hierarchyManager.getPendingEscalations(c.req.param('agentId'));
-    return c.json({ escalations });
-  } catch (e: any) {
-    return c.json({ error: e.message }, 500);
-  }
-});
-
-// ─── MCP Server Management ──────────────────────────────────────────
-// CRUD for external MCP server connections (stdio, SSE, HTTP)
-engine.get('/mcp-servers', async (c) => {
-  try {
-    const rows = await _engineDb!.query(`SELECT * FROM mcp_servers WHERE org_id = $1 ORDER BY created_at DESC`, ['default']);
-    const servers = (rows || []).map((r: any) => {
-      const config = typeof r.config === 'string' ? JSON.parse(r.config) : (r.config || {});
-      return { id: r.id, ...config, status: r.status || 'unknown', toolCount: r.tool_count || 0, tools: r.tools ? (typeof r.tools === 'string' ? JSON.parse(r.tools) : r.tools) : [] };
-    });
-    return c.json({ servers });
-  } catch (e: any) {
-    // Table may not exist yet
-    if (e.message?.includes('does not exist') || e.message?.includes('no such table')) {
-      return c.json({ servers: [] });
-    }
-    return c.json({ error: e.message }, 500);
-  }
-});
-
-engine.post('/mcp-servers', async (c) => {
-  try {
-    await _engineDb!.execute(`CREATE TABLE IF NOT EXISTS mcp_servers (
-      id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
-      org_id TEXT NOT NULL DEFAULT 'default',
-      config JSONB NOT NULL DEFAULT '{}',
-      status TEXT DEFAULT 'unknown',
-      tool_count INTEGER DEFAULT 0,
-      tools JSONB DEFAULT '[]',
-      created_at TIMESTAMPTZ DEFAULT NOW(),
-      updated_at TIMESTAMPTZ DEFAULT NOW()
-    )`);
-    const body = await c.req.json();
-    const id = crypto.randomUUID();
-    await _engineDb!.execute(`INSERT INTO mcp_servers (id, org_id, config) VALUES ($1, $2, $3)`, [id, 'default', JSON.stringify(body)]);
-    return c.json({ ok: true, id });
-  } catch (e: any) { return c.json({ error: e.message }, 500); }
-});
-
-engine.put('/mcp-servers/:id', async (c) => {
-  try {
-    const id = c.req.param('id');
-    const body = await c.req.json();
-    // Merge with existing config
-    const rows = await _engineDb!.query(`SELECT config FROM mcp_servers WHERE id = $1`, [id]);
-    if (!rows?.length) return c.json({ error: 'Server not found' }, 404);
-    const existing = typeof rows[0].config === 'string' ? JSON.parse(rows[0].config) : (rows[0].config || {});
-    const merged = { ...existing, ...body };
-    await _engineDb!.execute(`UPDATE mcp_servers SET config = $1, updated_at = NOW() WHERE id = $2`, [JSON.stringify(merged), id]);
-    return c.json({ ok: true });
-  } catch (e: any) { return c.json({ error: e.message }, 500); }
-});
-
-engine.delete('/mcp-servers/:id', async (c) => {
-  try {
-    const id = c.req.param('id');
-    // Fetch config before deleting (for agent notification)
-    const rows = await _engineDb!.query(`SELECT config, tools FROM mcp_servers WHERE id = $1`, [id]);
-    const serverConfig = rows?.[0] ? (typeof rows[0].config === 'string' ? JSON.parse(rows[0].config) : rows[0].config) : null;
-    const serverTools = rows?.[0]?.tools ? (typeof rows[0].tools === 'string' ? JSON.parse(rows[0].tools) : rows[0].tools) : [];
-
-    await _engineDb!.execute(`DELETE FROM mcp_servers WHERE id = $1`, [id]);
-
-    // Write a memory entry for each assigned agent so they know tools were removed
-    if (serverConfig?.assignedAgents?.length && memoryManager) {
-      const toolNames = (serverTools || []).map((t: any) => t.name).join(', ');
-      for (const agentId of serverConfig.assignedAgents) {
-        try {
-          await memoryManager.createMemory({
-            agentId,
-            orgId: 'default',
-            category: 'system_notice',
-            title: `MCP Server "${serverConfig.name}" was deleted`,
-            content: `The MCP server "${serverConfig.name}" has been permanently removed by an administrator. The following tools are no longer available and should NOT be called: ${toolNames || 'unknown'}. If a task requires these tools, inform the user that they are no longer available.`,
-            source: 'mcp_server_deletion',
-            importance: 'high',
-          });
-        } catch { /* non-fatal */ }
-      }
-    }
-
-    return c.json({ ok: true });
-  } catch (e: any) { return c.json({ error: e.message }, 500); }
-});
-
-// ─── MCP Server Agent Assignment ─────────────────────
-engine.put('/mcp-servers/:id/agents', async (c) => {
-  try {
-    const id = c.req.param('id');
-    const { agentIds } = await c.req.json<{ agentIds: string[] }>();
-    const rows = await _engineDb!.query(`SELECT config FROM mcp_servers WHERE id = $1`, [id]);
-    if (!rows?.length) return c.json({ error: 'Server not found' }, 404);
-    const existing = typeof rows[0].config === 'string' ? JSON.parse(rows[0].config) : (rows[0].config || {});
-    existing.assignedAgents = agentIds || [];
-    await _engineDb!.execute(`UPDATE mcp_servers SET config = $1, updated_at = NOW() WHERE id = $2`, [JSON.stringify(existing), id]);
-    return c.json({ ok: true });
-  } catch (e: any) { return c.json({ error: e.message }, 500); }
-});
-
-// ─── MCP Server Reload (after config change) ─────────
-engine.post('/mcp-servers/:id/reload', async (c) => {
-  try {
-    // Signal to runtime to reload this MCP server
-    // The actual reload happens via the mcpProcessManager reference
-    return c.json({ ok: true, message: 'Server will be reloaded on next agent session' });
-  } catch (e: any) { return c.json({ error: e.message }, 500); }
-});
-
-engine.post('/mcp-servers/:id/test', async (c) => {
-  try {
-    const id = c.req.param('id');
-    const rows = await _engineDb!.query(`SELECT config FROM mcp_servers WHERE id = $1`, [id]);
-    if (!rows?.length) return c.json({ error: 'Server not found' }, 404);
-    const config = typeof rows[0].config === 'string' ? JSON.parse(rows[0].config) : (rows[0].config || {});
-
-    if (config.type === 'stdio') {
-      // Test stdio: spawn process, send initialize, read response
-      const { spawn } = await import('node:child_process');
-      const args = config.args || [];
-      const env = { ...process.env, ...(config.env || {}) };
-      const child = spawn(config.command, args, { stdio: ['pipe', 'pipe', 'pipe'], env, timeout: (config.timeout || 30) * 1000 });
-
-      const initMsg = JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2024-11-05', capabilities: {}, clientInfo: { name: 'AgenticMail', version: '1.0' } } });
-      child.stdin.write(initMsg + '\n');
-
-      const result: any = await new Promise((resolve) => {
-        let buf = '';
-        const timer = setTimeout(() => { child.kill(); resolve({ error: 'Timeout after ' + (config.timeout || 30) + 's' }); }, (config.timeout || 30) * 1000);
-        child.stdout.on('data', (chunk: Buffer) => {
-          buf += chunk.toString();
-          try {
-            const parsed = JSON.parse(buf.trim());
-            clearTimeout(timer);
-            child.kill();
-            resolve(parsed);
-          } catch { /* wait for more data */ }
-        });
-        child.on('error', (err: any) => { clearTimeout(timer); resolve({ error: err.message }); });
-        child.on('exit', (code: number) => { if (!buf) { clearTimeout(timer); resolve({ error: 'Process exited with code ' + code }); } });
-      });
-
-      if (result.error) return c.json({ error: typeof result.error === 'string' ? result.error : result.error.message || 'Unknown error' });
-
-      // Now list tools
-      const listMsg = JSON.stringify({ jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} });
-      const child2 = spawn(config.command, args, { stdio: ['pipe', 'pipe', 'pipe'], env, timeout: 15000 });
-      child2.stdin.write(initMsg + '\n');
-
-      const tools: any[] = await new Promise((resolve) => {
-        let phase = 'init';
-        let buf2 = '';
-        const timer2 = setTimeout(() => { child2.kill(); resolve([]); }, 15000);
-        child2.stdout.on('data', (chunk: Buffer) => {
-          buf2 += chunk.toString();
-          const lines = buf2.split('\n');
-          for (const line of lines) {
-            if (!line.trim()) continue;
-            try {
-              const parsed = JSON.parse(line.trim());
-              if (phase === 'init' && parsed.id === 1) {
-                phase = 'tools';
-                buf2 = '';
-                child2.stdin.write(listMsg + '\n');
-              } else if (phase === 'tools' && parsed.id === 2) {
-                clearTimeout(timer2);
-                child2.kill();
-                resolve(parsed.result?.tools || []);
-                return;
-              }
-            } catch { /* partial line */ }
-          }
-        });
-        child2.on('error', () => { clearTimeout(timer2); resolve([]); });
-      });
-
-      // Save discovered tools
-      await _engineDb!.execute(`UPDATE mcp_servers SET status = 'connected', tool_count = $1, tools = $2, updated_at = NOW() WHERE id = $3`,
-        [tools.length, JSON.stringify(tools.map((t: any) => ({ name: t.name, description: t.description }))), id]);
-
-      return c.json({ ok: true, tools: tools.length, serverInfo: result.result?.serverInfo });
-
-    } else {
-      // Test HTTP/SSE: send initialize via HTTP
-      const url = config.url;
-      const headers: Record<string, string> = { 'Content-Type': 'application/json', ...(config.headers || {}) };
-      if (config.apiKey) headers['Authorization'] = `Bearer ${config.apiKey}`;
-
-      const resp = await fetch(url, {
-        method: 'POST',
-        headers,
-        body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2024-11-05', capabilities: {}, clientInfo: { name: 'AgenticMail', version: '1.0' } } }),
-        signal: AbortSignal.timeout((config.timeout || 30) * 1000),
-      });
-
-      if (!resp.ok) return c.json({ error: `Server returned ${resp.status}` });
-      const data = await resp.json() as any;
-      if (data.error) return c.json({ error: data.error.message || 'Server error' });
-
-      // List tools
-      const toolResp = await fetch(url, {
-        method: 'POST', headers,
-        body: JSON.stringify({ jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} }),
-        signal: AbortSignal.timeout(15000),
-      });
-      let tools: any[] = [];
-      if (toolResp.ok) {
-        const td = await toolResp.json() as any;
-        tools = td.result?.tools || [];
-      }
-
-      await _engineDb!.execute(`UPDATE mcp_servers SET status = 'connected', tool_count = $1, tools = $2, updated_at = NOW() WHERE id = $3`,
-        [tools.length, JSON.stringify(tools.map((t: any) => ({ name: t.name, description: t.description }))), id]);
-
-      return c.json({ ok: true, tools: tools.length, serverInfo: data.result?.serverInfo });
-    }
-  } catch (e: any) {
-    // Update status to error
-    try { await _engineDb!.execute(`UPDATE mcp_servers SET status = 'error', updated_at = NOW() WHERE id = $1`, [c.req.param('id')]); } catch {}
-    return c.json({ error: e.message });
-  }
-});
-
-// ─── Integration Credentials Management ─────────────────
-engine.put('/integrations/:skillId/credentials', async (c) => {
-  try {
-    const skillId = c.req.param('skillId');
-    const body = await c.req.json();
-    const orgId = c.req.query('orgId') || 'default';
-    // Store each credential field as a vault secret
-    for (const [key, value] of Object.entries(body)) {
-      if (!value) continue;
-      const secretName = `skill:${skillId}:${key}`;
-      // Check if exists, update or create
-      try {
-        const entries = await vault.getSecretsByOrg(orgId, 'skill_credential');
-        const existing = entries.find((e: any) => e.name === secretName);
-        if (existing) {
-          await vault.updateSecret(existing.id, value as string);
-        } else {
-          await vault.storeSecret(orgId, secretName, 'skill_credential', value as string);
-        }
-      } catch {
-        await vault.storeSecret(orgId, secretName, 'skill_credential', value as string);
-      }
-    }
-    return c.json({ ok: true });
-  } catch (e: any) { return c.json({ error: e.message }, 500); }
-});
-
-engine.delete('/integrations/:skillId/credentials', async (c) => {
-  try {
-    const skillId = c.req.param('skillId');
-    const orgId = c.req.query('orgId') || 'default';
-    const entries = await vault.getSecretsByOrg(orgId, 'skill_credential');
-    const matching = entries.filter((e: any) => e.name?.startsWith(`skill:${skillId}:`));
-    for (const entry of matching) {
-      await vault.deleteSecret(entry.id);
-    }
-    return c.json({ ok: true });
-  } catch (e: any) { return c.json({ error: e.message }, 500); }
-});
-
-// ─── Integration catalog (serves all 144 MCP adapter integrations) ──
-engine.get('/integrations/catalog', async (c) => {
-  try {
-    const { INTEGRATION_CATALOG, INTEGRATION_CATEGORIES } = await import('../mcp/integration-catalog.js');
-    const orgId = c.req.query('orgId') || 'default';
-    // Check which integrations have credentials in the vault
-    let connectedSkillIds: Set<string>;
-    try {
-      const entries = await vault.getSecretsByOrg(orgId, 'skill_credential');
-      connectedSkillIds = new Set(
-        entries
-          .map((e: any) => e.name?.match(/^skill:([^:]+):/)?.[1])
-          .filter(Boolean)
-      );
-    } catch { connectedSkillIds = new Set(); }
-    const catalog = INTEGRATION_CATALOG.map(e => ({
-      ...e,
-      connected: connectedSkillIds.has(e.skillId),
-    }));
-    return c.json({ catalog, categories: INTEGRATION_CATEGORIES });
-  } catch (e: any) {
-    return c.json({ error: e.message }, 500);
-  }
-});
-
-// ─── Integration-specific proxy endpoints ───────────────
-engine.get('/integrations/elevenlabs/voices', async (c) => {
-  try {
-    const orgId = c.req.query('orgId') || 'default';
-    const entries = await vault.getSecretsByOrg(orgId);
-    const match = entries.find((e: any) => e.name === 'skill:elevenlabs:access_token');
-    if (!match) return c.json({ error: 'ElevenLabs not connected' }, 401);
-    const secret = await vault.getSecret(match.id);
-    if (!secret) return c.json({ error: 'Key not found' }, 401);
-    const resp = await fetch('https://api.elevenlabs.io/v1/voices', {
-      headers: { 'xi-api-key': secret.decrypted },
-    });
-    if (!resp.ok) return c.json({ error: 'ElevenLabs API error: ' + resp.status }, resp.status as any);
-    const data = await resp.json() as any;
-    return c.json({ voices: data.voices || [] });
-  } catch (e: any) {
-    return c.json({ error: e.message }, 500);
-  }
-});
-engine.route('/chat-webhook', createChatWebhookRoutes({
-  lifecycle,
-  getRuntime: () => _runtime,
-  projectNumber: '927012824308',
-  getStandaloneAgents: () => lifecycle.getStandaloneAgents(),
-}));
-
-// ─── Chat Poller Management API ─────────────────────────
-engine.get('/chat-poller/status', (c) => {
-  const poller = _chatPoller;
-  if (!poller) return c.json({ running: false, reason: 'not_started' });
-  return c.json(poller.getStatus());
-});
-
-engine.get('/chat-poller/spaces', async (c) => {
-  try {
-    const db = _engineDb;
-    if (!db) return c.json({ spaces: [] });
-    const rows = await db.query(`SELECT key, value FROM engine_settings WHERE key = 'chat_spaces'`);
-    const spaces = rows?.[0] ? JSON.parse((rows[0] as any).value) : [];
-    return c.json({ spaces });
-  } catch { return c.json({ spaces: [] }); }
-});
-
-engine.post('/chat-poller/spaces', async (c) => {
-  try {
-    const db = _engineDb;
-    if (!db) return c.json({ error: 'Engine DB not ready' }, 500);
-    const body = await c.req.json<{ spaces: Array<{ spaceId: string; displayName: string; agentIds: string[]; defaultAgentId?: string }> }>();
-    if (!body.spaces || !Array.isArray(body.spaces)) return c.json({ error: 'spaces array required' }, 400);
-
-    await db.execute(
-      `INSERT INTO engine_settings (key, value) VALUES ('chat_spaces', $1)
-       ON CONFLICT (key) DO UPDATE SET value = $1`,
-      [JSON.stringify(body.spaces)]
-    );
-
-    // Update live poller
-    const poller = _chatPoller;
-    if (poller) {
-      for (const s of body.spaces) {
-        poller.addSpace({
-          spaceId: s.spaceId,
-          displayName: s.displayName,
-          agentIds: s.agentIds,
-          defaultAgentId: s.defaultAgentId,
-        });
-      }
-    }
-
-    return c.json({ ok: true, count: body.spaces.length });
-  } catch (err: any) {
-    return c.json({ error: err.message }, 500);
-  }
-});
-
-// ─── Email Poller Management API ────────────────────────
-engine.get('/email-poller/status', (c) => {
-  const poller = _emailPoller;
-  if (!poller) return c.json({ running: false, reason: 'not_started' });
-  return c.json(poller.getStatus());
-});
-
-engine.post('/email-poller/rediscover', async (c) => {
-  const poller = _emailPoller;
-  if (!poller) return c.json({ error: 'Email poller not started' }, 500);
-  await poller.rediscover();
-  return c.json({ ok: true });
-});
-
-// ─── setEngineDb ────────────────────────────────────────
-
-export async function setEngineDb(
-  db: import('./db-adapter.js').EngineDatabase,
-  adminDb?: DatabaseAdapter,
-) {
-  _engineDb = db;
-  if (adminDb) _adminDb = adminDb;
-
-  // Cascade DB to all engine modules for persistent storage
-  await Promise.all([
-    lifecycle.setDb(db).then(() => lifecycle.setVault(vault)),
-    approvals.setDb(db),
-    knowledgeBase.setDb(db),
-    activity.setDb(db),
-    tenants.setDb(db),
-    permissionEngine.setDb(db),
-    dlp.setDb(db),
-    commBus.setDb(db),
-    guardrails.setDb(db),
-    journal.setDb(db),
-    compliance.setDb(db),
-    communityRegistry.setDb(db),
-    knowledgeContribution.setDb(db),
-    (async () => { knowledgeImport.setDb((db as any)?.db || db); knowledgeImport.setKnowledgeEngine(knowledgeBase); await knowledgeImport.loadJobs(); })(),
-    workforce.setDb(db),
-    policyEngine.setDb(db),
-    (async () => { cluster.setDb(db); await cluster.loadFromDb(); })(),
-    memoryManager.setDb(db),
-    onboarding.setDb(db),
-    vault.setDb(db),
-    (async () => { orgIntegrations.setDb(db); orgIntegrations.setLifecycle(lifecycle); (globalThis as any).__orgIntegrations = orgIntegrations; })(),
-    storageManager.setDb(db),
-    policyImporter.setDb(db),
-    (async () => { (taskQueue as any).db = (db as any)?.db || db; await taskQueue.init(); })(),
-    databaseManager.setDb(db),
-  ]);
-  // Initialize hierarchy manager + start background task monitor
-  hierarchyManager = new AgentHierarchyManager(db);
-  hierarchyManager.startMonitor();
-
-  guardrails.startAnomalyDetection();
-  workforce.startScheduler();
-
-  // Load transport encryption config from settings
-  if (adminDb) {
-    setTransportEncSettingsDb(adminDb);
-    loadTransportEncConfig().catch(() => {});
-  }
-  knowledgeContribution.startScheduler();
-
-  // Auto-create contribution schedules for all agents if none exist
-  try {
-    const agents = lifecycle.getAllAgents();
-    const orgId = agents[0]?.orgId;
-    const allBases = orgId ? knowledgeContribution.listBases(orgId) : [];
-    // Debug removed - schedules auto-create silently
-    if (allBases.length > 0) {
-      const base = allBases[0];
-      for (const agent of agents) {
-        const existing = knowledgeContribution.getSchedule(agent.id);
-        if (!existing) {
-          try {
-            knowledgeContribution.createSchedule({
-              orgId: agent.orgId || base.orgId,
-              agentId: agent.id,
-              baseId: base.id,
-              frequency: 'daily',
-              filters: { minConfidence: 0.6 },
-            });
-            console.log(`[knowledge-contribution] Auto-created daily schedule for ${agent.config?.identity?.name as any || agent.id}`);
-          } catch { /* skip if base not found etc */ }
-        }
-      }
-    }
-  } catch (e: any) { console.log(`[knowledge-contribution] Auto-schedule setup: ${e.message}`); }
-
-  skillUpdater.startScheduler();
-
-  // Load community skills from the local community-skills/ directory (if running from git clone)
-  import('path').then(async (path) => {
-    const communityDir = path.resolve(import.meta.dirname || '.', '../../community-skills');
-    const { loaded, errors } = await communityRegistry.loadFromDirectory(communityDir);
-    if (loaded > 0) console.log(`[community] Loaded ${loaded} community skills from directory`);
-    if (errors.length > 0) console.warn(`[community] ${errors.length} skills failed validation`);
-  }).catch(() => { /* community-skills/ dir may not exist in npm installs */ });
-
-  // Start periodic sync from the central GitHub repo (agenticmail/enterprise).
-  // This is how npm-installed deployments get new community skills automatically
-  // without needing an npm update or server restart. Syncs every 6 hours.
-  communityRegistry.startPeriodicSync();
-
-  // Ensure a default org exists for single-tenant / self-hosted deployments
-  await tenants.createDefaultOrg().catch(() => {});
-
-  // ─── Start Google Chat Poller ─────────────────────────
-  // Guard: only start once (setEngineDb can be called multiple times)
-  if (!_chatPoller) {
-    startChatPoller(db).catch(err => console.error(`[chat-poller] Failed to start:`, err));
-  }
-
-  // ─── Start Gmail Email Poller ─────────────────────────
-  if (!_emailPoller) {
-    startEmailPoller(db).catch(err => console.error(`[email-poller] Failed to start:`, err));
-  }
-
-  // ─── Start Messaging Poller (WhatsApp, Telegram) ──
-  if (!_messagingPoller) {
-    startMessagingPoller(db).catch(err => console.error(`[messaging-poller] Failed to start:`, err));
-  }
-}
-
-// ─── Chat Poller ────────────────────────────────────────
-
-let _chatPoller: ChatPoller | null = null;
-
-async function startChatPoller(engineDb: any): Promise<void> {
-  console.log('[chat-poller] Initializing...');
-  // Find agents with chat enabled + OAuth tokens for Chat API access
-  const allAgents = lifecycle.getAllAgents();
-  console.log(`[chat-poller] Found ${allAgents.length} agents total`);
-  for (const a of allAgents) {
-    const services = a.config?.enabledGoogleServices || [];
-    const hasChat = services.includes('chat');
-    const hasOAuth = !!a.config?.emailConfig?.oauthRefreshToken;
-    const agentName = (a.config as any)?.displayName || (a.config as any)?.name || a.id;
-    console.log(`[chat-poller]   ${agentName}: services=[${services.join(',')}] chat=${hasChat} oauth=${hasOAuth} state=${a.state}`);
-  }
-  const chatAgents = allAgents.filter(a => {
-    const services = a.config?.enabledGoogleServices || [];
-    return services.includes('chat') && a.config?.emailConfig?.oauthRefreshToken;
-  });
-  console.log(`[chat-poller] Chat-enabled agents: ${chatAgents.length} (${chatAgents.map(a => a.name).join(', ')})`);
-
-  if (chatAgents.length === 0) {
-    console.log('[chat-poller] No chat-enabled agents with OAuth tokens, skipping');
-    return;
-  }
-
-  // Use the first chat-enabled agent's OAuth token for polling
-  // (all agents in the same org share the same Google Workspace)
-  const tokenAgent = chatAgents[0];
-  const emailConfig = tokenAgent.config!.emailConfig!;
-
-  const refreshToken = async (): Promise<string> => {
-    const res = await fetch('https://oauth2.googleapis.com/token', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-      body: new URLSearchParams({
-        client_id: emailConfig.oauthClientId,
-        client_secret: emailConfig.oauthClientSecret,
-        refresh_token: emailConfig.oauthRefreshToken,
-        grant_type: 'refresh_token',
-      }),
-    });
-    const data = await res.json() as any;
-    if (data.access_token) return data.access_token;
-    throw new Error(`Token refresh failed: ${data.error || 'unknown'}`);
-  };
-
-  // Build agent endpoints from known standalone agents + lifecycle agents
-  const standaloneAgentPorts: Record<string, number> = {};
-  // Check chat-webhook config for known ports
-  try {
-    const rows = await _engineDb!.query(`SELECT key, value FROM engine_settings WHERE key = 'standalone_agents'`);
-    if (rows?.[0]) {
-      const sa = JSON.parse((rows[0] as any).value);
-      for (const a of sa) standaloneAgentPorts[a.id] = a.port;
-    }
-  } catch {}
-
-  const agentEndpoints = chatAgents.map(a => {
-    const identity = a.config?.identity || {};
-    const name = a.config?.name || a.name || 'agent';
-    const displayName = a.config?.displayName || name;
-    const email = a.config?.emailConfig?.email || a.config?.email?.address || '';
-    // Port priority: DB standalone_agents setting → agent deployment config → fallback
-    const dep = a.config?.deployment;
-    const port = standaloneAgentPorts[a.id] || dep?.port || dep?.config?.local?.port || 3100;
-    const host = dep?.host || dep?.config?.local?.host || 'localhost';
-
-    return {
-      id: a.id,
-      name: name.toLowerCase(),
-      displayName,
-      email,
-      port,
-      host,
-      roles: (identity as any).roles || [identity.role].filter(Boolean),
-      keywords: (identity as any).keywords || [],
-      enabled: a.state === 'running',
-    };
-  });
-
-  _chatPoller = new ChatPoller({
-    lifecycle,
-    getToken: refreshToken,
-    engineDb,
-    agents: agentEndpoints,
-    intervalMs: 30_000,
-    workforce,
-  });
-
-  await _chatPoller.start();
-}
-
-export function getChatPoller(): ChatPoller | null {
-  return _chatPoller;
-}
-
-// ─── Email Poller ───────────────────────────────────────
-
-let _emailPoller: EmailPoller | null = null;
-
-async function startEmailPoller(engineDb: any): Promise<void> {
-  _emailPoller = new EmailPoller({
-    engineDb,
-    lifecycle,
-    intervalMs: 30_000,
-    workforce,
-  });
-
-  await _emailPoller.start();
-}
-
-export function getEmailPoller(): EmailPoller | null {
-  return _emailPoller;
-}
-
-// ─── Messaging Poller (WhatsApp, Telegram) ─────────
-
-let _messagingPoller: MessagingPoller | null = null;
-
-async function startMessagingPoller(engineDb: any): Promise<void> {
-  const allAgents = lifecycle.getAllAgents();
-  const agents = allAgents.filter(a => a.state === 'running' || a.state === 'draft' || a.state === 'stopped' || (a as any).status === 'active').map(a => {
-    const dep = a.config?.deployment;
-    const port = dep?.port || dep?.config?.local?.port || 3100;
-    const host = dep?.host || dep?.config?.local?.host || 'localhost';
-    // Debug removed — dynamic resolution in messaging-poller.resolveEndpoint()
-    return {
-      id: a.id, name: a.name || '', displayName: (a.config as any)?.displayName || a.name || a.id,
-      status: 'active' as const, port, host,
-    };
-  });
-
-  // Check platform capabilities via admin DB (has direct pool access)
-  let capabilities: any = {};
-  try {
-    if (_adminDb && (_adminDb as any).pool) {
-      const r = await (_adminDb as any).pool.query(`SELECT platform_capabilities FROM company_settings LIMIT 1`);
-      capabilities = r.rows?.[0]?.platform_capabilities || {};
-    } else {
-      // Fallback: try getSettings if available
-      const settings = await (_adminDb as any)?.getSettings?.();
-      capabilities = settings?.platformCapabilities || {};
-    }
-  } catch (err: any) {
-    console.log(`[messaging] Failed to read platform capabilities: ${err.message}`);
-  }
-
-  const hasAny = capabilities.whatsapp || capabilities.telegram;
-  if (!hasAny) {
-    console.log('[messaging-poller] No messaging channels enabled in Platform Capabilities');
-    return;
-  }
-
-  // Detect public URL for webhook support (fly.io, VPS, tunnel, etc.)
-  const publicUrl = process.env.PUBLIC_URL || process.env.RAILWAY_PUBLIC_DOMAIN
-    ? `https://${process.env.RAILWAY_PUBLIC_DOMAIN}` : process.env.FLY_APP_NAME
-    ? `https://${process.env.FLY_APP_NAME}.fly.dev` : process.env.RENDER_EXTERNAL_URL
-    || undefined;
-
-  _messagingPoller = new MessagingPoller({
-    agents: agents as any,
-    dataDir: process.env.DATA_DIR || '/tmp/agenticmail-data',
-    publicUrl,
-    app: (_engineApp || undefined) as any,
-    engineDb,
-    lifecycle: { getAgent: (id: string) => lifecycle.getAgent(id) },
-    getCapability: (key: string) => !!capabilities[key],
-    getAgentChannelConfig: (agentId: string) => {
-      try {
-        const a = lifecycle.getAgent(agentId);
-        return (a?.config as any)?.messagingChannels || null;
-      } catch { return null; }
-    },
-    getVaultKey: (name: string) => {
-      try {
-        const vault = ((lifecycle as any).getVault?.() || (lifecycle as any).vault);
-        return vault?.get?.(name) || null;
-      } catch { return null; }
-    },
-  });
-  await _messagingPoller.start();
-}
-
-export function getMessagingPoller(): MessagingPoller | null {
-  return _messagingPoller;
-}
-
-// ─── Agent Runtime (optional — mounted when runtime is started) ──
-
-let _runtimeApp: import('hono').Hono | null = null;
-let _runtime: any = null;
-
-export function mountRuntimeApp(app: import('hono').Hono): void {
-  _runtimeApp = app;
-  engine.route('/runtime', app);
-}
-
-export function setRuntime(runtime: any): void {
-  _runtime = runtime;
-}
-
-export { engine as engineRoutes };
-export { permissionEngine, configGen, deployer, approvals, lifecycle, knowledgeBase, tenants, activity, dlp, commBus, guardrails, journal, compliance, communityRegistry, workforce, policyEngine, memoryManager, onboarding, vault, storageManager, policyImporter, knowledgeContribution, skillUpdater, agentStatus, hierarchyManager, databaseManager, orgIntegrations, cluster };