apteva 0.4.57 → 0.7.0

package/src/db.ts

@@ -1,3133 +0,0 @@
-import { Database } from "bun:sqlite";
-import { join } from "path";
-import { mkdirSync, existsSync } from "fs";
-import { encrypt, decrypt, encryptObject, decryptObject } from "./crypto";
-import { randomBytes, createHash } from "crypto";
-
-// Types
-export interface MultiAgentConfig {
-  enabled: boolean;
-  group?: string; // Defaults to projectId if not specified
-}
-
-export interface AgentBuiltinTools {
-  webSearch: boolean;
-  webFetch: boolean;
-}
-
-export interface OperatorConfig {
-  enabled: boolean;
-  browser_provider?: string; // "browserengine" | "browserbase" | "steel" | "cdp"
-  display_width?: number;
-  display_height?: number;
-  max_actions_per_turn?: number;
-}
-
-export interface RealtimeConfig {
-  enabled: boolean;
-  sttProvider?: string;
-  sttModel?: string;
-  ttsProvider?: string;
-  ttsModel?: string;
-}
-
-export interface AgentFeatures {
-  memory: boolean;
-  tasks: boolean;
-  vision: boolean;
-  operator: boolean | OperatorConfig; // Can be boolean for backwards compat or full config
-  mcp: boolean;
-  realtime: boolean | RealtimeConfig; // Can be boolean for backwards compat or full config
-  files: boolean;
-  agents: boolean | MultiAgentConfig; // Can be boolean for backwards compat or full config
-  builtinTools?: AgentBuiltinTools;
-  maxTurns?: number; // Max agentic loop iterations per request (default 50)
-}
-
-export const DEFAULT_FEATURES: AgentFeatures = {
-  memory: true,
-  tasks: false,
-  vision: true,
-  operator: false,
-  mcp: false,
-  realtime: false,
-  files: false,
-  agents: false,
-  builtinTools: { webSearch: false, webFetch: false },
-  maxTurns: 50,
-};
-
-// Helper to normalize operator feature to OperatorConfig
-export function getOperatorConfig(features: AgentFeatures): OperatorConfig {
-  const op = features.operator;
-  if (typeof op === "boolean") {
-    return { enabled: op };
-  }
-  return op;
-}
-
-// Helper to normalize realtime feature to RealtimeConfig
-export function getRealtimeConfig(features: AgentFeatures): RealtimeConfig {
-  const rt = features.realtime;
-  if (typeof rt === "boolean") {
-    return { enabled: rt };
-  }
-  return rt;
-}
-
-// Helper to check if realtime is enabled
-export function isRealtimeEnabled(features: AgentFeatures): boolean {
-  if (typeof features.realtime === "boolean") return features.realtime;
-  return features.realtime.enabled;
-}
-
-// Helper to normalize agents feature to MultiAgentConfig
-export function getMultiAgentConfig(features: AgentFeatures, projectId?: string | null): MultiAgentConfig {
-  const agents = features.agents;
-  if (typeof agents === "boolean") {
-    return {
-      enabled: agents,
-      group: projectId || undefined,
-    };
-  }
-  // Only keep known fields (strip legacy "mode" coordinator/worker)
-  return {
-    enabled: agents.enabled,
-    group: agents.group || projectId || undefined,
-  };
-}
-
-export interface Agent {
-  id: string;
-  name: string;
-  model: string;
-  provider: string;
-  system_prompt: string;
-  status: "stopped" | "running";
-  port: number | null;
-  features: AgentFeatures;
-  mcp_servers: string[]; // Array of MCP server IDs
-  skills: string[]; // Array of Skill IDs
-  project_id: string | null; // Optional project grouping
-  api_key_encrypted: string | null; // Encrypted API key for agent authentication
-  created_at: string;
-  updated_at: string;
-}
-
-export interface Project {
-  id: string;
-  name: string;
-  description: string | null;
-  color: string; // Hex color for UI display
-  created_at: string;
-  updated_at: string;
-}
-
-export interface ProjectRow {
-  id: string;
-  name: string;
-  description: string | null;
-  color: string;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface AgentRow {
-  id: string;
-  name: string;
-  model: string;
-  provider: string;
-  system_prompt: string;
-  status: string;
-  port: number | null;
-  features: string | null;
-  mcp_servers: string | null;
-  skills: string | null;
-  project_id: string | null;
-  api_key_encrypted: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface Settings {
-  key: string;
-  value: string;
-}
-
-export interface ProviderKey {
-  id: string;
-  provider_id: string;
-  encrypted_key: string;
-  key_hint: string;
-  is_valid: boolean;
-  last_tested_at: string | null;
-  created_at: string;
-  project_id: string | null;  // NULL = global, otherwise project-scoped
-  name: string | null;        // Optional display name (e.g., "Production", "Development")
-}
-
-export interface ProviderKeyRow {
-  id: string;
-  provider_id: string;
-  encrypted_key: string;
-  key_hint: string;
-  is_valid: number;
-  last_tested_at: string | null;
-  created_at: string;
-  project_id: string | null;
-  name: string | null;
-}
-
-export interface McpServer {
-  id: string;
-  name: string;
-  type: "npm" | "pip" | "github" | "http" | "custom" | "local";
-  package: string | null;       // npm or pip package name
-  pip_module: string | null;    // For pip type: the module to run (e.g., "late.mcp")
-  command: string | null;
-  args: string | null;
-  env: Record<string, string>;
-  url: string | null; // For http type: the remote server URL
-  headers: Record<string, string>; // For http type: auth headers
-  port: number | null;
-  status: "stopped" | "running";
-  source: string | null; // e.g., "composio", "smithery", null for local
-  project_id: string | null; // null = global, otherwise project-scoped
-  created_at: string;
-}
-
-// Skill types
-export interface Skill {
-  id: string;
-  name: string;
-  description: string;
-  content: string; // Full SKILL.md body (markdown)
-  version: string; // Semantic version (e.g., "1.0.0")
-  license: string | null;
-  compatibility: string | null;
-  metadata: Record<string, string>;
-  allowed_tools: string[];
-  source: "local" | "skillsmp" | "github" | "import";
-  source_url: string | null;
-  enabled: boolean;
-  project_id: string | null; // null = global, otherwise project-scoped
-  created_at: string;
-  updated_at: string;
-}
-
-export interface SkillRow {
-  id: string;
-  name: string;
-  description: string;
-  content: string;
-  version: string;
-  license: string | null;
-  compatibility: string | null;
-  metadata: string | null;
-  allowed_tools: string | null;
-  source: string;
-  source_url: string | null;
-  enabled: number;
-  project_id: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-// Subscription: maps trigger events to agents for routing
-export interface Subscription {
-  id: string;
-  trigger_slug: string;
-  trigger_instance_id: string | null;
-  agent_id: string;
-  enabled: boolean;
-  project_id: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface SubscriptionRow {
-  id: string;
-  trigger_slug: string;
-  trigger_instance_id: string | null;
-  agent_id: string;
-  enabled: number;
-  project_id: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-// Channel: external messaging platform bound to an agent
-export interface Channel {
-  id: string;
-  type: "telegram"; // future: "slack", "discord"
-  name: string;
-  agent_id: string;
-  config: string; // encrypted JSON
-  status: "stopped" | "running" | "error";
-  error: string | null;
-  project_id: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface ChannelRow {
-  id: string;
-  type: string;
-  name: string;
-  agent_id: string;
-  config: string;
-  status: string;
-  error: string | null;
-  project_id: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface McpServerRow {
-  id: string;
-  name: string;
-  type: string;
-  package: string | null;
-  pip_module: string | null;
-  command: string | null;
-  args: string | null;
-  env: string | null;
-  url: string | null;
-  headers: string | null;
-  port: number | null;
-  status: string;
-  source: string | null;
-  project_id: string | null;
-  created_at: string;
-}
-
-// MCP Server Tool types (for local servers)
-export interface McpServerTool {
-  id: string;
-  server_id: string;
-  name: string;
-  description: string;
-  input_schema: Record<string, any>;
-  handler_type: "mock" | "http" | "javascript";
-  mock_response: Record<string, any> | null;
-  http_config: { method?: string; url: string; headers?: Record<string, string>; body?: any } | null;
-  code: string | null;
-  enabled: boolean;
-  created_at: string;
-}
-
-interface McpServerToolRow {
-  id: string;
-  server_id: string;
-  name: string;
-  description: string;
-  input_schema: string;
-  handler_type: string;
-  mock_response: string | null;
-  http_config: string | null;
-  code: string | null;
-  enabled: number;
-  created_at: string;
-}
-
-// Database instance
-let db: Database;
-
-// Initialize database
-export function initDatabase(dataDir: string): Database {
-  // Ensure data directory exists
-  if (!existsSync(dataDir)) {
-    mkdirSync(dataDir, { recursive: true });
-  }
-
-  const dbPath = join(dataDir, "apteva.db");
-  db = new Database(dbPath);
-
-  // Enable WAL mode for better concurrent access
-  db.run("PRAGMA journal_mode = WAL");
-  db.run("PRAGMA busy_timeout = 5000");
-  db.run("PRAGMA foreign_keys = ON");
-
-  // Performance PRAGMAs
-  db.run("PRAGMA synchronous = NORMAL"); // Safe with WAL, much faster than FULL
-  db.run("PRAGMA cache_size = -20000"); // 20MB page cache (negative = KB)
-  db.run("PRAGMA mmap_size = 30000000"); // 30MB memory-mapped I/O
-  db.run("PRAGMA temp_store = MEMORY"); // Keep temp tables in memory
-
-  // Run migrations
-  runMigrations();
-
-  // Auto-set instance_url from env if not already configured
-  const envInstanceUrl = process.env.INSTANCE_URL || process.env.PUBLIC_URL;
-  if (envInstanceUrl) {
-    const current = SettingsDB.get("instance_url");
-    if (!current) {
-      SettingsDB.set("instance_url", envInstanceUrl.replace(/\/+$/, ""));
-    }
-  }
-
-  // Database initialized silently
-  return db;
-}
-
-// Get database instance
-export function getDb(): Database {
-  if (!db) {
-    throw new Error("Database not initialized. Call initDatabase() first.");
-  }
-  return db;
-}
-
-// Migrations
-function runMigrations() {
-  // Create migrations table if not exists
-  db.run(`
-    CREATE TABLE IF NOT EXISTS migrations (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      name TEXT NOT NULL UNIQUE,
-      applied_at TEXT DEFAULT CURRENT_TIMESTAMP
-    )
-  `);
-
-  const migrations: { name: string; sql: string }[] = [
-    {
-      name: "001_create_agents",
-      sql: `
-        CREATE TABLE IF NOT EXISTS agents (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          model TEXT NOT NULL,
-          provider TEXT NOT NULL,
-          system_prompt TEXT NOT NULL DEFAULT 'You are a helpful assistant.',
-          status TEXT NOT NULL DEFAULT 'stopped',
-          port INTEGER,
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          updated_at TEXT DEFAULT CURRENT_TIMESTAMP
-        );
-        CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
-        CREATE INDEX IF NOT EXISTS idx_agents_provider ON agents(provider);
-      `,
-    },
-    {
-      name: "002_create_settings",
-      sql: `
-        CREATE TABLE IF NOT EXISTS settings (
-          key TEXT PRIMARY KEY,
-          value TEXT NOT NULL,
-          updated_at TEXT DEFAULT CURRENT_TIMESTAMP
-        );
-      `,
-    },
-    {
-      name: "003_create_threads",
-      sql: `
-        CREATE TABLE IF NOT EXISTS threads (
-          id TEXT PRIMARY KEY,
-          agent_id TEXT NOT NULL,
-          title TEXT,
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          updated_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          FOREIGN KEY (agent_id) REFERENCES agents(id) ON DELETE CASCADE
-        );
-        CREATE INDEX IF NOT EXISTS idx_threads_agent ON threads(agent_id);
-      `,
-    },
-    {
-      name: "004_create_messages",
-      sql: `
-        CREATE TABLE IF NOT EXISTS messages (
-          id TEXT PRIMARY KEY,
-          thread_id TEXT NOT NULL,
-          role TEXT NOT NULL,
-          content TEXT NOT NULL,
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          FOREIGN KEY (thread_id) REFERENCES threads(id) ON DELETE CASCADE
-        );
-        CREATE INDEX IF NOT EXISTS idx_messages_thread ON messages(thread_id);
-      `,
-    },
-    {
-      name: "005_create_provider_keys",
-      sql: `
-        CREATE TABLE IF NOT EXISTS provider_keys (
-          id TEXT PRIMARY KEY,
-          provider_id TEXT NOT NULL UNIQUE,
-          encrypted_key TEXT NOT NULL,
-          key_hint TEXT,
-          is_valid INTEGER DEFAULT 1,
-          last_tested_at TEXT,
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP
-        );
-        CREATE INDEX IF NOT EXISTS idx_provider_keys_provider ON provider_keys(provider_id);
-      `,
-    },
-    {
-      name: "006_add_agent_features",
-      sql: `
-        ALTER TABLE agents ADD COLUMN features TEXT DEFAULT '{"memory":true,"tasks":false,"vision":true,"operator":false,"mcp":false,"realtime":false}';
-      `,
-    },
-    {
-      name: "007_create_mcp_servers",
-      sql: `
-        CREATE TABLE IF NOT EXISTS mcp_servers (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          type TEXT NOT NULL DEFAULT 'npm',
-          package TEXT,
-          command TEXT,
-          args TEXT,
-          env TEXT DEFAULT '{}',
-          port INTEGER,
-          status TEXT NOT NULL DEFAULT 'stopped',
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP
-        );
-        CREATE INDEX IF NOT EXISTS idx_mcp_servers_status ON mcp_servers(status);
-      `,
-    },
-    {
-      name: "008_add_agent_mcp_servers",
-      sql: `
-        ALTER TABLE agents ADD COLUMN mcp_servers TEXT DEFAULT '[]';
-      `,
-    },
-    {
-      name: "009_create_telemetry",
-      sql: `
-        CREATE TABLE IF NOT EXISTS telemetry_events (
-          id TEXT PRIMARY KEY,
-          agent_id TEXT NOT NULL,
-          timestamp TEXT NOT NULL,
-          category TEXT NOT NULL,
-          type TEXT NOT NULL,
-          level TEXT NOT NULL,
-          trace_id TEXT,
-          span_id TEXT,
-          thread_id TEXT,
-          data TEXT,
-          metadata TEXT,
-          duration_ms INTEGER,
-          error TEXT,
-          received_at TEXT NOT NULL
-        );
-        CREATE INDEX IF NOT EXISTS idx_telemetry_agent ON telemetry_events(agent_id);
-        CREATE INDEX IF NOT EXISTS idx_telemetry_time ON telemetry_events(timestamp);
-        CREATE INDEX IF NOT EXISTS idx_telemetry_agent_time ON telemetry_events(agent_id, timestamp DESC);
-        CREATE INDEX IF NOT EXISTS idx_telemetry_category ON telemetry_events(category);
-        CREATE INDEX IF NOT EXISTS idx_telemetry_level ON telemetry_events(level);
-        CREATE INDEX IF NOT EXISTS idx_telemetry_trace ON telemetry_events(trace_id);
-      `,
-    },
-    {
-      name: "010_create_users",
-      sql: `
-        CREATE TABLE IF NOT EXISTS users (
-          id TEXT PRIMARY KEY,
-          username TEXT UNIQUE NOT NULL,
-          password_hash TEXT NOT NULL,
-          email TEXT,
-          role TEXT NOT NULL DEFAULT 'user',
-          created_at TEXT NOT NULL DEFAULT (datetime('now')),
-          updated_at TEXT NOT NULL DEFAULT (datetime('now')),
-          last_login_at TEXT
-        );
-        CREATE UNIQUE INDEX IF NOT EXISTS idx_users_username ON users(username);
-      `,
-    },
-    {
-      name: "011_create_sessions",
-      sql: `
-        CREATE TABLE IF NOT EXISTS sessions (
-          id TEXT PRIMARY KEY,
-          user_id TEXT NOT NULL,
-          refresh_token_hash TEXT NOT NULL,
-          expires_at TEXT NOT NULL,
-          created_at TEXT NOT NULL DEFAULT (datetime('now')),
-          FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
-        );
-        CREATE INDEX IF NOT EXISTS idx_sessions_user ON sessions(user_id);
-        CREATE INDEX IF NOT EXISTS idx_sessions_expires ON sessions(expires_at);
-      `,
-    },
-    {
-      name: "012_create_projects",
-      sql: `
-        CREATE TABLE IF NOT EXISTS projects (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          description TEXT,
-          color TEXT NOT NULL DEFAULT '#6366f1',
-          created_at TEXT NOT NULL DEFAULT (datetime('now')),
-          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-        );
-        CREATE INDEX IF NOT EXISTS idx_projects_name ON projects(name);
-      `,
-    },
-    {
-      name: "013_add_agent_project_id",
-      sql: `
-        ALTER TABLE agents ADD COLUMN project_id TEXT REFERENCES projects(id) ON DELETE SET NULL;
-        CREATE INDEX IF NOT EXISTS idx_agents_project ON agents(project_id);
-      `,
-    },
-    {
-      name: "014_add_mcp_server_url_headers",
-      sql: `
-        ALTER TABLE mcp_servers ADD COLUMN url TEXT;
-        ALTER TABLE mcp_servers ADD COLUMN headers TEXT DEFAULT '{}';
-        ALTER TABLE mcp_servers ADD COLUMN source TEXT;
-      `,
-    },
-    {
-      name: "015_add_agent_api_key",
-      sql: `
-        ALTER TABLE agents ADD COLUMN api_key_encrypted TEXT;
-      `,
-    },
-    {
-      name: "016_create_skills",
-      sql: `
-        CREATE TABLE IF NOT EXISTS skills (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          description TEXT NOT NULL,
-          content TEXT NOT NULL,
-          license TEXT,
-          compatibility TEXT,
-          metadata TEXT DEFAULT '{}',
-          allowed_tools TEXT DEFAULT '[]',
-          source TEXT NOT NULL DEFAULT 'local',
-          source_url TEXT,
-          enabled INTEGER DEFAULT 1,
-          created_at TEXT NOT NULL DEFAULT (datetime('now')),
-          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-        );
-        CREATE INDEX IF NOT EXISTS idx_skills_name ON skills(name);
-        CREATE INDEX IF NOT EXISTS idx_skills_source ON skills(source);
-        CREATE INDEX IF NOT EXISTS idx_skills_enabled ON skills(enabled);
-      `,
-    },
-    {
-      name: "017_add_skills_to_agents",
-      sql: `
-        ALTER TABLE agents ADD COLUMN skills TEXT DEFAULT '[]';
-      `,
-    },
-    {
-      name: "018_add_skill_version",
-      sql: `
-        ALTER TABLE skills ADD COLUMN version TEXT DEFAULT '1.0.0';
-      `,
-    },
-    {
-      name: "019_add_mcp_server_project_id",
-      sql: `
-        ALTER TABLE mcp_servers ADD COLUMN project_id TEXT REFERENCES projects(id) ON DELETE SET NULL;
-        CREATE INDEX IF NOT EXISTS idx_mcp_servers_project ON mcp_servers(project_id);
-      `,
-    },
-    {
-      name: "020_add_skill_project_id",
-      sql: `
-        ALTER TABLE skills ADD COLUMN project_id TEXT REFERENCES projects(id) ON DELETE SET NULL;
-        CREATE INDEX IF NOT EXISTS idx_skills_project ON skills(project_id);
-      `,
-    },
-    {
-      name: "021_add_mcp_server_pip_module",
-      sql: `
-        ALTER TABLE mcp_servers ADD COLUMN pip_module TEXT;
-      `,
-    },
-    {
-      name: "022_add_provider_keys_project_id",
-      sql: `
-        -- Add project_id column for project-scoped integration keys
-        -- NULL project_id means global (default)
-        ALTER TABLE provider_keys ADD COLUMN project_id TEXT REFERENCES projects(id) ON DELETE CASCADE;
-        ALTER TABLE provider_keys ADD COLUMN name TEXT;
-
-        -- Create index for project lookups
-        CREATE INDEX IF NOT EXISTS idx_provider_keys_project ON provider_keys(project_id);
-
-        -- Create unique index on (provider_id, project_id) - allows one key per provider per project
-        -- Note: SQLite treats NULL as distinct, so we use COALESCE
-        CREATE UNIQUE INDEX IF NOT EXISTS idx_provider_keys_unique ON provider_keys(provider_id, COALESCE(project_id, ''));
-      `,
-    },
-    {
-      name: "023_create_test_cases",
-      sql: `
-        CREATE TABLE IF NOT EXISTS test_cases (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          description TEXT,
-          agent_id TEXT NOT NULL,
-          input_message TEXT NOT NULL,
-          eval_criteria TEXT NOT NULL,
-          timeout_ms INTEGER DEFAULT 60000,
-          project_id TEXT,
-          created_at TEXT NOT NULL DEFAULT (datetime('now')),
-          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-        );
-        CREATE INDEX IF NOT EXISTS idx_test_cases_agent ON test_cases(agent_id);
-        CREATE INDEX IF NOT EXISTS idx_test_cases_project ON test_cases(project_id);
-      `,
-    },
-    {
-      name: "025_create_api_keys",
-      sql: `
-        CREATE TABLE IF NOT EXISTS api_keys (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          key_hash TEXT NOT NULL UNIQUE,
-          key_prefix TEXT NOT NULL,
-          user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
-          expires_at TEXT,
-          last_used_at TEXT,
-          is_active INTEGER DEFAULT 1,
-          created_at TEXT NOT NULL DEFAULT (datetime('now'))
-        );
-        CREATE INDEX IF NOT EXISTS idx_api_keys_hash ON api_keys(key_hash) WHERE is_active = 1;
-        CREATE INDEX IF NOT EXISTS idx_api_keys_user ON api_keys(user_id);
-      `,
-    },
-    {
-      name: "024_create_test_runs",
-      sql: `
-        CREATE TABLE IF NOT EXISTS test_runs (
-          id TEXT PRIMARY KEY,
-          test_case_id TEXT NOT NULL,
-          status TEXT NOT NULL DEFAULT 'running',
-          agent_response TEXT,
-          judge_reasoning TEXT,
-          duration_ms INTEGER,
-          error TEXT,
-          created_at TEXT NOT NULL DEFAULT (datetime('now')),
-          FOREIGN KEY (test_case_id) REFERENCES test_cases(id) ON DELETE CASCADE
-        );
-        CREATE INDEX IF NOT EXISTS idx_test_runs_test_case ON test_runs(test_case_id);
-        CREATE INDEX IF NOT EXISTS idx_test_runs_status ON test_runs(status);
-      `,
-    },
-    {
-      name: "026_behavior_tests",
-      sql: `
-        -- Recreate test_cases with nullable agent_id and input_message
-        CREATE TABLE IF NOT EXISTS test_cases_new (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          description TEXT,
-          behavior TEXT,
-          agent_id TEXT,
-          input_message TEXT,
-          eval_criteria TEXT NOT NULL DEFAULT '',
-          timeout_ms INTEGER DEFAULT 300000,
-          project_id TEXT,
-          created_at TEXT NOT NULL DEFAULT (datetime('now')),
-          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-        );
-        INSERT OR IGNORE INTO test_cases_new (id, name, description, agent_id, input_message, eval_criteria, timeout_ms, project_id, created_at, updated_at)
-          SELECT id, name, description, agent_id, input_message, eval_criteria, timeout_ms, project_id, created_at, updated_at FROM test_cases;
-        DROP TABLE IF EXISTS test_cases;
-        ALTER TABLE test_cases_new RENAME TO test_cases;
-        CREATE INDEX IF NOT EXISTS idx_test_cases_agent ON test_cases(agent_id);
-        CREATE INDEX IF NOT EXISTS idx_test_cases_project ON test_cases(project_id);
-
-        -- Add planner columns to test_runs
-        ALTER TABLE test_runs ADD COLUMN generated_message TEXT;
-        ALTER TABLE test_runs ADD COLUMN selected_agent_id TEXT;
-        ALTER TABLE test_runs ADD COLUMN selected_agent_name TEXT;
-        ALTER TABLE test_runs ADD COLUMN planner_reasoning TEXT;
-      `,
-    },
-    {
-      name: "027_fix_test_cases_nullable",
-      sql: `
-        -- Recreate test_cases with nullable agent_id and input_message
-        CREATE TABLE IF NOT EXISTS test_cases_new (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          description TEXT,
-          behavior TEXT,
-          agent_id TEXT,
-          input_message TEXT,
-          eval_criteria TEXT NOT NULL DEFAULT '',
-          timeout_ms INTEGER DEFAULT 300000,
-          project_id TEXT,
-          created_at TEXT NOT NULL DEFAULT (datetime('now')),
-          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-        );
-        INSERT OR IGNORE INTO test_cases_new (id, name, description, behavior, agent_id, input_message, eval_criteria, timeout_ms, project_id, created_at, updated_at)
-          SELECT id, name, description, behavior, agent_id, input_message, eval_criteria, timeout_ms, project_id, created_at, updated_at FROM test_cases;
-        DROP TABLE IF EXISTS test_cases;
-        ALTER TABLE test_cases_new RENAME TO test_cases;
-        CREATE INDEX IF NOT EXISTS idx_test_cases_agent ON test_cases(agent_id);
-        CREATE INDEX IF NOT EXISTS idx_test_cases_project ON test_cases(project_id);
-      `,
-    },
-    {
-      name: "028_add_test_run_score",
-      sql: `ALTER TABLE test_runs ADD COLUMN score INTEGER;`,
-    },
-    {
-      name: "030_create_mcp_server_tools",
-      sql: `
-        CREATE TABLE IF NOT EXISTS mcp_server_tools (
-          id TEXT PRIMARY KEY,
-          server_id TEXT NOT NULL,
-          name TEXT NOT NULL,
-          description TEXT NOT NULL,
-          input_schema TEXT NOT NULL DEFAULT '{}',
-          handler_type TEXT NOT NULL DEFAULT 'mock',
-          mock_response TEXT DEFAULT '{}',
-          http_config TEXT DEFAULT NULL,
-          code TEXT DEFAULT NULL,
-          enabled INTEGER DEFAULT 1,
-          created_at TEXT DEFAULT (datetime('now')),
-          FOREIGN KEY (server_id) REFERENCES mcp_servers(id) ON DELETE CASCADE
-        );
-        CREATE UNIQUE INDEX IF NOT EXISTS idx_mcp_server_tools_name ON mcp_server_tools(server_id, name);
-        CREATE INDEX IF NOT EXISTS idx_mcp_server_tools_server ON mcp_server_tools(server_id);
-      `,
-    },
-    {
-      name: "031_create_subscriptions",
-      sql: `
-        CREATE TABLE IF NOT EXISTS subscriptions (
-          id TEXT PRIMARY KEY,
-          trigger_slug TEXT NOT NULL,
-          trigger_instance_id TEXT,
-          agent_id TEXT NOT NULL,
-          enabled INTEGER NOT NULL DEFAULT 1,
-          project_id TEXT,
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          updated_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          FOREIGN KEY (agent_id) REFERENCES agents(id) ON DELETE CASCADE
-        );
-        CREATE INDEX IF NOT EXISTS idx_subscriptions_agent ON subscriptions(agent_id);
-        CREATE INDEX IF NOT EXISTS idx_subscriptions_trigger_slug ON subscriptions(trigger_slug);
-        CREATE INDEX IF NOT EXISTS idx_subscriptions_trigger_instance ON subscriptions(trigger_instance_id);
-      `,
-    },
-    {
-      name: "032_create_channels",
-      sql: `
-        CREATE TABLE IF NOT EXISTS channels (
-          id TEXT PRIMARY KEY,
-          type TEXT NOT NULL,
-          name TEXT NOT NULL,
-          agent_id TEXT NOT NULL,
-          config TEXT NOT NULL,
-          status TEXT DEFAULT 'stopped',
-          error TEXT,
-          project_id TEXT,
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          updated_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          FOREIGN KEY (agent_id) REFERENCES agents(id) ON DELETE CASCADE
-        );
-        CREATE INDEX IF NOT EXISTS idx_channels_agent ON channels(agent_id);
-        CREATE INDEX IF NOT EXISTS idx_channels_status ON channels(status);
-      `,
-    },
-    {
-      name: "033_add_telemetry_seen",
-      sql: `
-        ALTER TABLE telemetry_events ADD COLUMN seen INTEGER DEFAULT 0;
-        CREATE INDEX IF NOT EXISTS idx_telemetry_seen ON telemetry_events(seen);
-      `,
-    },
-    {
-      name: "029_fix_provider_keys_unique_constraint",
-      sql: `
-        -- Recreate provider_keys table without UNIQUE constraint on provider_id alone
-        -- This allows multiple keys per provider (one per project)
-        CREATE TABLE IF NOT EXISTS provider_keys_new (
-          id TEXT PRIMARY KEY,
-          provider_id TEXT NOT NULL,
-          encrypted_key TEXT NOT NULL,
-          key_hint TEXT,
-          is_valid INTEGER DEFAULT 1,
-          last_tested_at TEXT,
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
-          name TEXT
-        );
-        INSERT OR IGNORE INTO provider_keys_new (id, provider_id, encrypted_key, key_hint, is_valid, last_tested_at, created_at, project_id, name)
-          SELECT id, provider_id, encrypted_key, key_hint, is_valid, last_tested_at, created_at, project_id, name FROM provider_keys;
-        DROP TABLE IF EXISTS provider_keys;
-        ALTER TABLE provider_keys_new RENAME TO provider_keys;
-        CREATE INDEX IF NOT EXISTS idx_provider_keys_provider ON provider_keys(provider_id);
-        CREATE INDEX IF NOT EXISTS idx_provider_keys_project ON provider_keys(project_id);
-        CREATE UNIQUE INDEX IF NOT EXISTS idx_provider_keys_unique ON provider_keys(provider_id, COALESCE(project_id, ''));
-      `,
-    },
-    {
-      name: "034_repair_provider_keys_project_support",
-      sql: `
-        -- Repair: migrations 022 and 029 may have failed but were marked as applied.
-        -- Recreate provider_keys with project_id support from whatever current state.
-        CREATE TABLE IF NOT EXISTS provider_keys_repair (
-          id TEXT PRIMARY KEY,
-          provider_id TEXT NOT NULL,
-          encrypted_key TEXT NOT NULL,
-          key_hint TEXT,
-          is_valid INTEGER DEFAULT 1,
-          last_tested_at TEXT,
-          created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-          project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
-          name TEXT
-        );
-        INSERT OR IGNORE INTO provider_keys_repair (id, provider_id, encrypted_key, key_hint, is_valid, last_tested_at, created_at)
-          SELECT id, provider_id, encrypted_key, key_hint, is_valid, last_tested_at, created_at FROM provider_keys;
-        DROP TABLE IF EXISTS provider_keys;
-        ALTER TABLE provider_keys_repair RENAME TO provider_keys;
-        CREATE INDEX IF NOT EXISTS idx_provider_keys_provider ON provider_keys(provider_id);
-        CREATE INDEX IF NOT EXISTS idx_provider_keys_project ON provider_keys(project_id);
-        CREATE UNIQUE INDEX IF NOT EXISTS idx_provider_keys_unique ON provider_keys(provider_id, COALESCE(project_id, ''));
-      `,
-    },
-    {
-      name: "035_add_telemetry_cost",
-      sql: `
-        ALTER TABLE telemetry_events ADD COLUMN cost REAL DEFAULT 0;
-      `,
-    },
-  ];
-
-  // Check which migrations have been applied
-  const applied = new Set<string>();
-  const rows = db.query("SELECT name FROM migrations").all() as { name: string }[];
-  for (const row of rows) {
-    applied.add(row.name);
-  }
-
-  // Run pending migrations
-  for (const migration of migrations) {
-    if (!applied.has(migration.name)) {
-      try {
-        // Migration runs silently (exec supports multi-statement SQL)
-        db.exec(migration.sql);
-        db.run("INSERT INTO migrations (name) VALUES (?)", [migration.name]);
-      } catch (err) {
-        // Log error but continue - some migrations may fail if partially applied
-        console.error(`[db] Migration ${migration.name} failed:`, err);
-        // Still mark as applied to avoid retrying broken migrations
-        try {
-          db.run("INSERT INTO migrations (name) VALUES (?)", [migration.name]);
-        } catch {
-          // Ignore if already marked
-        }
-      }
-    }
-  }
-
-  // Schema upgrade migrations (check actual table structure)
-  runSchemaUpgrades();
-}
-
-// Handle schema changes that require checking actual table structure
-function runSchemaUpgrades() {
-  // Check if users table needs migration from email-based to username-based
-  const tableInfo = db.query("PRAGMA table_info(users)").all() as { name: string }[];
-  const columns = new Set(tableInfo.map(c => c.name));
-
-  // Old schema has 'email' as required + 'name', new schema has 'username' + optional 'email'
-  if (columns.has("name") && !columns.has("username")) {
-    console.log("[db] Migrating users table from email-based to username-based auth...");
-
-    // Get existing users
-    const existingUsers = db.query("SELECT * FROM users").all() as any[];
-
-    // Drop old table and indexes
-    db.run("DROP INDEX IF EXISTS idx_users_email");
-    db.run("DROP TABLE users");
-
-    // Create new schema
-    db.run(`
-      CREATE TABLE users (
-        id TEXT PRIMARY KEY,
-        username TEXT UNIQUE NOT NULL,
-        password_hash TEXT NOT NULL,
-        email TEXT,
-        role TEXT NOT NULL DEFAULT 'user',
-        created_at TEXT NOT NULL DEFAULT (datetime('now')),
-        updated_at TEXT NOT NULL DEFAULT (datetime('now')),
-        last_login_at TEXT
-      )
-    `);
-    db.run("CREATE UNIQUE INDEX idx_users_username ON users(username)");
-
-    // Migrate existing users (use part before @ in email as username)
-    for (const user of existingUsers) {
-      const username = user.email.split("@")[0].replace(/[^a-zA-Z0-9_]/g, "_").slice(0, 20);
-      db.run(
-        `INSERT INTO users (id, username, password_hash, email, role, created_at, updated_at, last_login_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
-        [user.id, username, user.password_hash, user.email, user.role, user.created_at, user.updated_at, user.last_login_at]
-      );
-    }
-
-    if (existingUsers.length > 0) {
-      console.log(`[db] Migrated ${existingUsers.length} user(s). Usernames derived from email addresses.`);
-    }
-  }
-
-  // Assign permanent ports to MCP servers that don't have one yet
-  // (HTTP-type servers don't need a local proxy port)
-  const mcpWithoutPort = db.query("SELECT id FROM mcp_servers WHERE port IS NULL AND type NOT IN ('http', 'local')").all() as { id: string }[];
-  if (mcpWithoutPort.length > 0) {
-    const MCP_BASE_PORT = 4500;
-    const maxRow = db.query("SELECT MAX(port) as max_port FROM mcp_servers").get() as { max_port: number | null };
-    let nextPort = maxRow.max_port !== null ? maxRow.max_port + 1 : MCP_BASE_PORT;
-    for (const row of mcpWithoutPort) {
-      db.run("UPDATE mcp_servers SET port = ? WHERE id = ?", [nextPort, row.id]);
-      nextPort++;
-    }
-  }
-}
-
-// Generate a unique API key for an agent
-function generateAgentApiKey(agentId: string): string {
-  const randomPart = randomBytes(24).toString("hex");
-  return `agt_${randomPart}`;
-}
-
-// Agent CRUD operations
-export const AgentDB = {
-  // Get the next available port for a new agent (starting from 4100)
-  getNextAvailablePort(): number {
-    const BASE_PORT = 4100;
-    const row = db.query("SELECT MAX(port) as max_port FROM agents").get() as { max_port: number | null };
-    if (row.max_port === null) {
-      return BASE_PORT;
-    }
-    return row.max_port + 1;
-  },
-
-  // Create a new agent with a permanently assigned port and API key
-  create(agent: Omit<Agent, "created_at" | "updated_at" | "status" | "api_key_encrypted"> & { port?: number }): Agent {
-    const now = new Date().toISOString();
-    const featuresJson = JSON.stringify(agent.features || DEFAULT_FEATURES);
-    const mcpServersJson = JSON.stringify(agent.mcp_servers || []);
-    const skillsJson = JSON.stringify(agent.skills || []);
-    // Assign port permanently at creation time
-    const port = agent.port ?? this.getNextAvailablePort();
-    // Generate and encrypt API key
-    const apiKey = generateAgentApiKey(agent.id);
-    const apiKeyEncrypted = encrypt(apiKey);
-    const stmt = db.prepare(`
-      INSERT INTO agents (id, name, model, provider, system_prompt, features, mcp_servers, skills, project_id, status, port, api_key_encrypted, created_at, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'stopped', ?, ?, ?, ?)
-    `);
-    stmt.run(agent.id, agent.name, agent.model, agent.provider, agent.system_prompt, featuresJson, mcpServersJson, skillsJson, agent.project_id || null, port, apiKeyEncrypted, now, now);
-    return this.findById(agent.id)!;
-  },
-
-  // Find agent by ID
-  findById(id: string): Agent | null {
-    const row = db.query("SELECT * FROM agents WHERE id = ?").get(id) as AgentRow | null;
-    return row ? rowToAgent(row) : null;
-  },
-
-  // Get all agents
-  findAll(): Agent[] {
-    const rows = db.query("SELECT * FROM agents ORDER BY created_at DESC").all() as AgentRow[];
-    return rows.map(rowToAgent);
-  },
-
-  // Get running agents
-  findRunning(): Agent[] {
-    const rows = db.query("SELECT * FROM agents WHERE status = 'running'").all() as AgentRow[];
-    return rows.map(rowToAgent);
-  },
-
-
-  // Update agent
-  update(id: string, updates: Partial<Omit<Agent, "id" | "created_at">>): Agent | null {
-    const agent = this.findById(id);
-    if (!agent) return null;
-
-    const fields: string[] = [];
-    const values: unknown[] = [];
-
-    if (updates.name !== undefined) {
-      fields.push("name = ?");
-      values.push(updates.name);
-    }
-    if (updates.model !== undefined) {
-      fields.push("model = ?");
-      values.push(updates.model);
-    }
-    if (updates.provider !== undefined) {
-      fields.push("provider = ?");
-      values.push(updates.provider);
-    }
-    if (updates.system_prompt !== undefined) {
-      fields.push("system_prompt = ?");
-      values.push(updates.system_prompt);
-    }
-    if (updates.status !== undefined) {
-      fields.push("status = ?");
-      values.push(updates.status);
-    }
-    if (updates.port !== undefined) {
-      fields.push("port = ?");
-      values.push(updates.port);
-    }
-    if (updates.features !== undefined) {
-      fields.push("features = ?");
-      values.push(JSON.stringify(updates.features));
-    }
-    if (updates.mcp_servers !== undefined) {
-      fields.push("mcp_servers = ?");
-      values.push(JSON.stringify(updates.mcp_servers));
-    }
-    if (updates.skills !== undefined) {
-      fields.push("skills = ?");
-      values.push(JSON.stringify(updates.skills));
-    }
-    if (updates.project_id !== undefined) {
-      fields.push("project_id = ?");
-      values.push(updates.project_id);
-    }
-    if (fields.length > 0) {
-      fields.push("updated_at = ?");
-      values.push(new Date().toISOString());
-      values.push(id);
-
-      db.run(`UPDATE agents SET ${fields.join(", ")} WHERE id = ?`, values);
-    }
-
-    return this.findById(id);
-  },
-
-  // Find agents by project
-  findByProject(projectId: string | null): Agent[] {
-    if (projectId === null) {
-      const rows = db.query("SELECT * FROM agents WHERE project_id IS NULL ORDER BY created_at DESC").all() as AgentRow[];
-      return rows.map(rowToAgent);
-    }
-    const rows = db.query("SELECT * FROM agents WHERE project_id = ? ORDER BY created_at DESC").all(projectId) as AgentRow[];
-    return rows.map(rowToAgent);
-  },
-
-  // Find agents that have a specific skill
-  findBySkill(skillId: string): Agent[] {
-    // Use json_each to properly search the JSON array (avoids full table scan with LIKE)
-    const rows = db.query(
-      `SELECT DISTINCT a.* FROM agents a, json_each(a.skills) AS s WHERE s.value = ? ORDER BY a.created_at DESC`
-    ).all(skillId) as AgentRow[];
-    return rows.map(rowToAgent);
-  },
-
-  // Delete agent
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM agents WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-
-  // Set agent status (port is permanently assigned, don't change it)
-  setStatus(id: string, status: "stopped" | "running"): Agent | null {
-    return this.update(id, { status });
-  },
-
-  // Reset all agents to stopped (on server restart) - keep ports as they're permanent
-  resetAllStatus(): void {
-    db.run("UPDATE agents SET status = 'stopped'");
-  },
-
-  // Count agents
-  count(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM agents").get() as { count: number };
-    return row.count;
-  },
-
-  // Count running agents
-  countRunning(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM agents WHERE status = 'running'").get() as { count: number };
-    return row.count;
-  },
-
-  // In-memory cache for decrypted API keys (avoids expensive scryptSync on every request)
-  _apiKeyCache: new Map<string, string>(),
-
-  // Get decrypted API key for an agent (cached)
-  getApiKey(id: string): string | null {
-    // Check cache first
-    const cached = this._apiKeyCache.get(id);
-    if (cached) return cached;
-
-    const agent = this.findById(id);
-    if (!agent || !agent.api_key_encrypted) {
-      return null;
-    }
-    try {
-      const key = decrypt(agent.api_key_encrypted);
-      if (key) this._apiKeyCache.set(id, key);
-      return key;
-    } catch {
-      return null;
-    }
-  },
-
-  // Regenerate API key for an agent
-  regenerateApiKey(id: string): string | null {
-    const agent = this.findById(id);
-    if (!agent) return null;
-
-    const newApiKey = generateAgentApiKey(id);
-    const encrypted = encrypt(newApiKey);
-    const now = new Date().toISOString();
-
-    db.run(
-      "UPDATE agents SET api_key_encrypted = ?, updated_at = ? WHERE id = ?",
-      [encrypted, now, id]
-    );
-
-    // Update cache
-    this._apiKeyCache.set(id, newApiKey);
-    return newApiKey;
-  },
-
-  // Ensure agent has an API key (for migration of existing agents)
-  ensureApiKey(id: string): string | null {
-    const agent = this.findById(id);
-    if (!agent) return null;
-
-    // If agent already has a key, return it
-    if (agent.api_key_encrypted) {
-      try {
-        const key = decrypt(agent.api_key_encrypted);
-        if (key) this._apiKeyCache.set(id, key);
-        return key;
-      } catch {
-        // Key is corrupted, regenerate
-      }
-    }
-
-    // Generate new key for agents without one
-    return this.regenerateApiKey(id);
-  },
-};
-
-// Project CRUD operations
-export const ProjectDB = {
-  // Create a new project
-  create(project: { name: string; description?: string | null; color?: string }): Project {
-    const id = generateId();
-    const now = new Date().toISOString();
-    const color = project.color || "#6366f1";
-
-    db.run(
-      `INSERT INTO projects (id, name, description, color, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?)`,
-      [id, project.name, project.description || null, color, now, now]
-    );
-
-    return this.findById(id)!;
-  },
-
-  // Find project by ID
-  findById(id: string): Project | null {
-    const row = db.query("SELECT * FROM projects WHERE id = ?").get(id) as ProjectRow | null;
-    return row ? rowToProject(row) : null;
-  },
-
-  // Get all projects
-  findAll(): Project[] {
-    const rows = db.query("SELECT * FROM projects ORDER BY name ASC").all() as ProjectRow[];
-    return rows.map(rowToProject);
-  },
-
-  // Update project
-  update(id: string, updates: Partial<Omit<Project, "id" | "created_at">>): Project | null {
-    const project = this.findById(id);
-    if (!project) return null;
-
-    const fields: string[] = [];
-    const values: unknown[] = [];
-
-    if (updates.name !== undefined) {
-      fields.push("name = ?");
-      values.push(updates.name);
-    }
-    if (updates.description !== undefined) {
-      fields.push("description = ?");
-      values.push(updates.description);
-    }
-    if (updates.color !== undefined) {
-      fields.push("color = ?");
-      values.push(updates.color);
-    }
-
-    if (fields.length > 0) {
-      fields.push("updated_at = ?");
-      values.push(new Date().toISOString());
-      values.push(id);
-
-      db.run(`UPDATE projects SET ${fields.join(", ")} WHERE id = ?`, values);
-    }
-
-    return this.findById(id);
-  },
-
-  // Delete project with full cleanup
-  // FK constraints handle: agents, mcp_servers, skills (SET NULL), provider_keys (CASCADE)
-  // Manual cleanup: subscriptions, test_cases (no FK on project_id)
-  delete(id: string): boolean {
-    db.run("UPDATE subscriptions SET project_id = NULL WHERE project_id = ?", [id]);
-    db.run("UPDATE test_cases SET project_id = NULL WHERE project_id = ?", [id]);
-    const result = db.run("DELETE FROM projects WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-
-  // Count projects
-  count(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM projects").get() as { count: number };
-    return row.count;
-  },
-
-  // Get agent count per project (excludes meta agent)
-  getAgentCounts(): Map<string | null, number> {
-    const rows = db.query(`
-      SELECT project_id, COUNT(*) as count
-      FROM agents
-      WHERE id != 'apteva-assistant'
-      GROUP BY project_id
-    `).all() as { project_id: string | null; count: number }[];
-
-    const counts = new Map<string | null, number>();
-    for (const row of rows) {
-      counts.set(row.project_id, row.count);
-    }
-    return counts;
-  },
-};
-
-// Helper to convert DB row to Project type
-function rowToProject(row: ProjectRow): Project {
-  return {
-    id: row.id,
-    name: row.name,
-    description: row.description,
-    color: row.color,
-    created_at: row.created_at,
-    updated_at: row.updated_at,
-  };
-}
-
-// Thread CRUD operations
-export const ThreadDB = {
-  create(id: string, agentId: string, title?: string): void {
-    const now = new Date().toISOString();
-    db.run(
-      "INSERT INTO threads (id, agent_id, title, created_at, updated_at) VALUES (?, ?, ?, ?, ?)",
-      [id, agentId, title || null, now, now]
-    );
-  },
-
-  findById(id: string) {
-    return db.query("SELECT * FROM threads WHERE id = ?").get(id);
-  },
-
-  findByAgent(agentId: string) {
-    return db.query("SELECT * FROM threads WHERE agent_id = ? ORDER BY updated_at DESC").all(agentId);
-  },
-
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM threads WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-};
-
-// Message CRUD operations
-export const MessageDB = {
-  create(id: string, threadId: string, role: string, content: string): void {
-    db.run(
-      "INSERT INTO messages (id, thread_id, role, content) VALUES (?, ?, ?, ?)",
-      [id, threadId, role, content]
-    );
-    // Update thread's updated_at
-    db.run("UPDATE threads SET updated_at = CURRENT_TIMESTAMP WHERE id = ?", [threadId]);
-  },
-
-  findByThread(threadId: string) {
-    return db.query("SELECT * FROM messages WHERE thread_id = ? ORDER BY created_at ASC").all(threadId);
-  },
-};
-
-// Settings operations
-export const SettingsDB = {
-  get(key: string): string | null {
-    const row = db.query("SELECT value FROM settings WHERE key = ?").get(key) as { value: string } | null;
-    return row?.value ?? null;
-  },
-
-  set(key: string, value: string): void {
-    db.run(
-      "INSERT INTO settings (key, value, updated_at) VALUES (?, ?, CURRENT_TIMESTAMP) ON CONFLICT(key) DO UPDATE SET value = ?, updated_at = CURRENT_TIMESTAMP",
-      [key, value, value]
-    );
-  },
-
-  delete(key: string): boolean {
-    const result = db.run("DELETE FROM settings WHERE key = ?", [key]);
-    return result.changes > 0;
-  },
-};
-
-// Helper to convert DB row to Agent type
-function rowToAgent(row: AgentRow): Agent {
-  let features = DEFAULT_FEATURES;
-  if (row.features) {
-    try {
-      features = { ...DEFAULT_FEATURES, ...JSON.parse(row.features) };
-      // Strip legacy "mode" from multi-agent config
-      if (features.agents && typeof features.agents === "object") {
-        const { mode, ...rest } = features.agents as any;
-        features.agents = rest;
-      }
-    } catch {
-      // Use defaults if parsing fails
-    }
-  }
-  let mcp_servers: string[] = [];
-  if (row.mcp_servers) {
-    try {
-      mcp_servers = JSON.parse(row.mcp_servers);
-    } catch {
-      // Use empty array if parsing fails
-    }
-  }
-  let skills: string[] = [];
-  if (row.skills) {
-    try {
-      skills = JSON.parse(row.skills);
-    } catch {
-      // Use empty array if parsing fails
-    }
-  }
-  return {
-    id: row.id,
-    name: row.name,
-    model: row.model,
-    provider: row.provider,
-    system_prompt: row.system_prompt,
-    status: row.status as "stopped" | "running",
-    port: row.port,
-    features,
-    mcp_servers,
-    skills,
-    project_id: row.project_id,
-    api_key_encrypted: row.api_key_encrypted,
-    created_at: row.created_at,
-    updated_at: row.updated_at,
-  };
-}
-
-// Provider Keys operations
-export const ProviderKeysDB = {
-  // Save or update a provider key (project_id: null = global)
-  save(providerId: string, encryptedKey: string, keyHint: string, projectId: string | null = null, name: string | null = null): ProviderKey {
-    const existing = this.findByProviderAndProject(providerId, projectId);
-    const now = new Date().toISOString();
-
-    if (existing) {
-      db.run(
-        "UPDATE provider_keys SET encrypted_key = ?, key_hint = ?, name = ?, is_valid = 1, last_tested_at = NULL, created_at = ? WHERE id = ?",
-        [encryptedKey, keyHint, name, now, existing.id]
-      );
-      return this.findById(existing.id)!;
-    } else {
-      const id = generateId();
-      db.run(
-        "INSERT INTO provider_keys (id, provider_id, encrypted_key, key_hint, is_valid, created_at, project_id, name) VALUES (?, ?, ?, ?, 1, ?, ?, ?)",
-        [id, providerId, encryptedKey, keyHint, now, projectId, name]
-      );
-      return this.findById(id)!;
-    }
-  },
-
-  // Find key by ID
-  findById(id: string): ProviderKey | null {
-    const row = db.query("SELECT * FROM provider_keys WHERE id = ?").get(id) as ProviderKeyRow | null;
-    return row ? rowToProviderKey(row) : null;
-  },
-
-  // Find key by provider (global only - for backwards compatibility)
-  findByProvider(providerId: string): ProviderKey | null {
-    const row = db.query("SELECT * FROM provider_keys WHERE provider_id = ? AND project_id IS NULL").get(providerId) as ProviderKeyRow | null;
-    return row ? rowToProviderKey(row) : null;
-  },
-
-  // Find key by provider and project
-  findByProviderAndProject(providerId: string, projectId: string | null): ProviderKey | null {
-    const row = projectId
-      ? db.query("SELECT * FROM provider_keys WHERE provider_id = ? AND project_id = ?").get(providerId, projectId) as ProviderKeyRow | null
-      : db.query("SELECT * FROM provider_keys WHERE provider_id = ? AND project_id IS NULL").get(providerId) as ProviderKeyRow | null;
-    return row ? rowToProviderKey(row) : null;
-  },
-
-  // Find all keys for a provider (global + all projects)
-  findAllByProvider(providerId: string): ProviderKey[] {
-    const rows = db.query("SELECT * FROM provider_keys WHERE provider_id = ? ORDER BY (project_id IS NOT NULL), created_at DESC").all(providerId) as ProviderKeyRow[];
-    return rows.map(rowToProviderKey);
-  },
-
-  // Find all keys for a project
-  findByProject(projectId: string): ProviderKey[] {
-    const rows = db.query("SELECT * FROM provider_keys WHERE project_id = ? ORDER BY provider_id, created_at DESC").all(projectId) as ProviderKeyRow[];
-    return rows.map(rowToProviderKey);
-  },
-
-  // Get all provider keys
-  findAll(): ProviderKey[] {
-    const rows = db.query("SELECT * FROM provider_keys ORDER BY provider_id, (project_id IS NOT NULL), created_at DESC").all() as ProviderKeyRow[];
-    return rows.map(rowToProviderKey);
-  },
-
-  // Get list of provider IDs that have keys configured (global keys only for backwards compat)
-  getConfiguredProviders(): string[] {
-    const rows = db.query("SELECT DISTINCT provider_id FROM provider_keys WHERE project_id IS NULL").all() as { provider_id: string }[];
-    return rows.map(r => r.provider_id);
-  },
-
-  // Get list of provider IDs that have keys configured (including project-scoped)
-  getAllConfiguredProviders(): string[] {
-    const rows = db.query("SELECT DISTINCT provider_id FROM provider_keys").all() as { provider_id: string }[];
-    return rows.map(r => r.provider_id);
-  },
-
-  // Update validity status after testing
-  setValidity(id: string, isValid: boolean): void {
-    db.run(
-      "UPDATE provider_keys SET is_valid = ?, last_tested_at = ? WHERE id = ?",
-      [isValid ? 1 : 0, new Date().toISOString(), id]
-    );
-  },
-
-  // Delete a provider key by ID
-  deleteById(id: string): boolean {
-    const result = db.run("DELETE FROM provider_keys WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-
-  // Delete a provider key (global only - for backwards compatibility)
-  delete(providerId: string): boolean {
-    const result = db.run("DELETE FROM provider_keys WHERE provider_id = ? AND project_id IS NULL", [providerId]);
-    return result.changes > 0;
-  },
-
-  // Delete provider key by provider and project
-  deleteByProviderAndProject(providerId: string, projectId: string | null): boolean {
-    const result = projectId
-      ? db.run("DELETE FROM provider_keys WHERE provider_id = ? AND project_id = ?", [providerId, projectId])
-      : db.run("DELETE FROM provider_keys WHERE provider_id = ? AND project_id IS NULL", [providerId]);
-    return result.changes > 0;
-  },
-
-  // Check if any keys are configured
-  hasAnyKeys(): boolean {
-    const row = db.query("SELECT COUNT(*) as count FROM provider_keys").get() as { count: number };
-    return row.count > 0;
-  },
-
-  // Count configured providers
-  count(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM provider_keys").get() as { count: number };
-    return row.count;
-  },
-};
-
-// Helper to convert DB row to ProviderKey type
-function rowToProviderKey(row: ProviderKeyRow): ProviderKey {
-  return {
-    id: row.id,
-    provider_id: row.provider_id,
-    encrypted_key: row.encrypted_key,
-    key_hint: row.key_hint,
-    is_valid: row.is_valid === 1,
-    last_tested_at: row.last_tested_at,
-    created_at: row.created_at,
-    project_id: row.project_id,
-    name: row.name,
-  };
-}
-
-// MCP Server operations
-export const McpServerDB = {
-  // Get the next available port for a new MCP server (starting from 4500)
-  getNextAvailablePort(): number {
-    const BASE_PORT = 4500;
-    const row = db.query("SELECT MAX(port) as max_port FROM mcp_servers").get() as { max_port: number | null };
-    if (row.max_port === null) {
-      return BASE_PORT;
-    }
-    return row.max_port + 1;
-  },
-
-  create(server: Omit<McpServer, "created_at" | "status" | "port">): McpServer {
-    const now = new Date().toISOString();
-    // Encrypt env vars and headers (credentials) before storing
-    const envEncrypted = encryptObject(server.env || {});
-    const headersEncrypted = encryptObject(server.headers || {});
-    // Assign port permanently at creation time (like agents)
-    // HTTP and local servers don't need a local proxy port
-    const port = (server.type === "http" || server.type === "local") ? null : this.getNextAvailablePort();
-    console.log(`[McpServerDB.create] id=${server.id} name=${server.name} type=${server.type} source=${server.source} project_id=${server.project_id} url=${server.url?.substring(0, 60)}`);
-    const stmt = db.prepare(`
-      INSERT INTO mcp_servers (id, name, type, package, pip_module, command, args, env, url, headers, source, project_id, status, port, created_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'stopped', ?, ?)
-    `);
-    stmt.run(
-      server.id, server.name, server.type, server.package, server.pip_module || null, server.command, server.args,
-      envEncrypted, server.url || null, headersEncrypted, server.source || null, server.project_id || null, port, now
-    );
-    const created = this.findById(server.id);
-    console.log(`[McpServerDB.create] findById after INSERT: ${created ? `found id=${created.id} project_id=${created.project_id}` : "NOT FOUND"}`);
-    if (!created) {
-      console.error(`[McpServerDB.create] CRITICAL: INSERT succeeded but findById returned null for id=${server.id}`);
-    }
-    return created!;
-  },
-
-  findById(id: string): McpServer | null {
-    const row = db.query("SELECT * FROM mcp_servers WHERE id = ?").get(id) as McpServerRow | null;
-    return row ? rowToMcpServer(row) : null;
-  },
-
-  findByIds(ids: string[]): Map<string, McpServer> {
-    if (ids.length === 0) return new Map();
-    const placeholders = ids.map(() => "?").join(",");
-    const rows = db.query(`SELECT * FROM mcp_servers WHERE id IN (${placeholders})`).all(...ids) as McpServerRow[];
-    const map = new Map<string, McpServer>();
-    for (const row of rows) map.set(row.id, rowToMcpServer(row));
-    return map;
-  },
-
-  findAll(): McpServer[] {
-    const rows = db.query("SELECT * FROM mcp_servers ORDER BY created_at DESC").all() as McpServerRow[];
-    return rows.map(rowToMcpServer);
-  },
-
-  // Light version: skips expensive decryption for listing endpoints
-  findAllLight(): McpServer[] {
-    const rows = db.query("SELECT * FROM mcp_servers ORDER BY created_at DESC").all() as McpServerRow[];
-    return rows.map(rowToMcpServerLight);
-  },
-
-  // Light batch load by IDs: skips decryption (used by toApiAgentsBatch)
-  findByIdsLight(ids: string[]): Map<string, McpServer> {
-    if (ids.length === 0) return new Map();
-    const placeholders = ids.map(() => "?").join(",");
-    const rows = db.query(`SELECT * FROM mcp_servers WHERE id IN (${placeholders})`).all(...ids) as McpServerRow[];
-    const map = new Map<string, McpServer>();
-    for (const row of rows) map.set(row.id, rowToMcpServerLight(row));
-    return map;
-  },
-
-  findRunning(): McpServer[] {
-    const rows = db.query("SELECT * FROM mcp_servers WHERE status = 'running'").all() as McpServerRow[];
-    return rows.map(rowToMcpServer);
-  },
-
-  update(id: string, updates: Partial<Omit<McpServer, "id" | "created_at">>): McpServer | null {
-    const server = this.findById(id);
-    if (!server) return null;
-
-    const fields: string[] = [];
-    const values: unknown[] = [];
-
-    if (updates.name !== undefined) {
-      fields.push("name = ?");
-      values.push(updates.name);
-    }
-    if (updates.type !== undefined) {
-      fields.push("type = ?");
-      values.push(updates.type);
-    }
-    if (updates.package !== undefined) {
-      fields.push("package = ?");
-      values.push(updates.package);
-    }
-    if (updates.pip_module !== undefined) {
-      fields.push("pip_module = ?");
-      values.push(updates.pip_module);
-    }
-    if (updates.command !== undefined) {
-      fields.push("command = ?");
-      values.push(updates.command);
-    }
-    if (updates.args !== undefined) {
-      fields.push("args = ?");
-      values.push(updates.args);
-    }
-    if (updates.env !== undefined) {
-      fields.push("env = ?");
-      // Encrypt env vars (credentials) before storing
-      values.push(encryptObject(updates.env));
-    }
-    if (updates.url !== undefined) {
-      fields.push("url = ?");
-      values.push(updates.url);
-    }
-    if (updates.headers !== undefined) {
-      fields.push("headers = ?");
-      // Encrypt headers (may contain auth tokens) before storing
-      values.push(encryptObject(updates.headers));
-    }
-    if (updates.source !== undefined) {
-      fields.push("source = ?");
-      values.push(updates.source);
-    }
-    if (updates.project_id !== undefined) {
-      fields.push("project_id = ?");
-      values.push(updates.project_id);
-    }
-    if (updates.port !== undefined) {
-      fields.push("port = ?");
-      values.push(updates.port);
-    }
-    if (updates.status !== undefined) {
-      fields.push("status = ?");
-      values.push(updates.status);
-    }
-
-    if (fields.length > 0) {
-      values.push(id);
-      db.run(`UPDATE mcp_servers SET ${fields.join(", ")} WHERE id = ?`, values);
-    }
-
-    return this.findById(id);
-  },
-
-  setStatus(id: string, status: "stopped" | "running", port?: number): McpServer | null {
-    // Port is permanently assigned — only update if explicitly provided
-    const updates: Partial<Omit<McpServer, "id" | "created_at">> = { status };
-    if (port !== undefined) {
-      updates.port = port;
-    }
-    return this.update(id, updates);
-  },
-
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM mcp_servers WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-
-  resetAllStatus(): void {
-    // Keep ports as they're permanently assigned (like agents)
-    db.run("UPDATE mcp_servers SET status = 'stopped'");
-  },
-
-  count(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM mcp_servers").get() as { count: number };
-    return row.count;
-  },
-
-  // Find servers by project (null = global only)
-  findByProject(projectId: string | null): McpServer[] {
-    if (projectId === null) {
-      const rows = db.query("SELECT * FROM mcp_servers WHERE project_id IS NULL ORDER BY created_at DESC").all() as McpServerRow[];
-      return rows.map(rowToMcpServer);
-    }
-    const rows = db.query("SELECT * FROM mcp_servers WHERE project_id = ? ORDER BY created_at DESC").all(projectId) as McpServerRow[];
-    return rows.map(rowToMcpServer);
-  },
-
-  // Find servers available for an agent (global + agent's project)
-  findForAgent(agentProjectId: string | null): McpServer[] {
-    if (agentProjectId === null) {
-      // Agent has no project, only show global servers
-      const rows = db.query("SELECT * FROM mcp_servers WHERE project_id IS NULL ORDER BY created_at DESC").all() as McpServerRow[];
-      return rows.map(rowToMcpServer);
-    }
-    // Agent has a project, show global + project servers
-    const rows = db.query("SELECT * FROM mcp_servers WHERE project_id IS NULL OR project_id = ? ORDER BY created_at DESC").all(agentProjectId) as McpServerRow[];
-    return rows.map(rowToMcpServer);
-  },
-
-  // Find global servers only
-  findGlobal(): McpServer[] {
-    const rows = db.query("SELECT * FROM mcp_servers WHERE project_id IS NULL ORDER BY created_at DESC").all() as McpServerRow[];
-    return rows.map(rowToMcpServer);
-  },
-
-  // Light versions (skip decryption) for listing endpoints
-  findByProjectLight(projectId: string | null): McpServer[] {
-    if (projectId === null) {
-      const rows = db.query("SELECT * FROM mcp_servers WHERE project_id IS NULL ORDER BY created_at DESC").all() as McpServerRow[];
-      return rows.map(rowToMcpServerLight);
-    }
-    const rows = db.query("SELECT * FROM mcp_servers WHERE project_id = ? ORDER BY created_at DESC").all(projectId) as McpServerRow[];
-    return rows.map(rowToMcpServerLight);
-  },
-
-  findForAgentLight(agentProjectId: string | null): McpServer[] {
-    if (agentProjectId === null) {
-      const rows = db.query("SELECT * FROM mcp_servers WHERE project_id IS NULL ORDER BY created_at DESC").all() as McpServerRow[];
-      return rows.map(rowToMcpServerLight);
-    }
-    const rows = db.query("SELECT * FROM mcp_servers WHERE project_id IS NULL OR project_id = ? ORDER BY created_at DESC").all(agentProjectId) as McpServerRow[];
-    return rows.map(rowToMcpServerLight);
-  },
-
-  findGlobalLight(): McpServer[] {
-    const rows = db.query("SELECT * FROM mcp_servers WHERE project_id IS NULL ORDER BY created_at DESC").all() as McpServerRow[];
-    return rows.map(rowToMcpServerLight);
-  },
-};
-
-// MCP Server Tool CRUD operations (for local servers)
-export const McpServerToolDB = {
-  create(tool: Omit<McpServerTool, "created_at">): McpServerTool {
-    const now = new Date().toISOString();
-    db.run(
-      `INSERT INTO mcp_server_tools (id, server_id, name, description, input_schema, handler_type, mock_response, http_config, code, enabled, created_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-      [
-        tool.id,
-        tool.server_id,
-        tool.name,
-        tool.description,
-        JSON.stringify(tool.input_schema || {}),
-        tool.handler_type || "mock",
-        tool.mock_response ? JSON.stringify(tool.mock_response) : null,
-        tool.http_config ? JSON.stringify(tool.http_config) : null,
-        tool.code || null,
-        tool.enabled ? 1 : 0,
-        now,
-      ],
-    );
-    return this.findById(tool.id)!;
-  },
-
-  findById(id: string): McpServerTool | null {
-    const row = db.query("SELECT * FROM mcp_server_tools WHERE id = ?").get(id) as McpServerToolRow | null;
-    return row ? rowToMcpServerTool(row) : null;
-  },
-
-  findByServer(serverId: string): McpServerTool[] {
-    const rows = db.query(
-      "SELECT * FROM mcp_server_tools WHERE server_id = ? ORDER BY created_at ASC",
-    ).all(serverId) as McpServerToolRow[];
-    return rows.map(rowToMcpServerTool);
-  },
-
-  findByServerAndName(serverId: string, name: string): McpServerTool | null {
-    const row = db.query(
-      "SELECT * FROM mcp_server_tools WHERE server_id = ? AND name = ?",
-    ).get(serverId, name) as McpServerToolRow | null;
-    return row ? rowToMcpServerTool(row) : null;
-  },
-
-  update(id: string, updates: Partial<Omit<McpServerTool, "id" | "server_id" | "created_at">>): McpServerTool | null {
-    const tool = this.findById(id);
-    if (!tool) return null;
-
-    const fields: string[] = [];
-    const values: unknown[] = [];
-
-    if (updates.name !== undefined) { fields.push("name = ?"); values.push(updates.name); }
-    if (updates.description !== undefined) { fields.push("description = ?"); values.push(updates.description); }
-    if (updates.input_schema !== undefined) { fields.push("input_schema = ?"); values.push(JSON.stringify(updates.input_schema)); }
-    if (updates.handler_type !== undefined) { fields.push("handler_type = ?"); values.push(updates.handler_type); }
-    if (updates.mock_response !== undefined) { fields.push("mock_response = ?"); values.push(updates.mock_response ? JSON.stringify(updates.mock_response) : null); }
-    if (updates.http_config !== undefined) { fields.push("http_config = ?"); values.push(updates.http_config ? JSON.stringify(updates.http_config) : null); }
-    if (updates.code !== undefined) { fields.push("code = ?"); values.push(updates.code); }
-    if (updates.enabled !== undefined) { fields.push("enabled = ?"); values.push(updates.enabled ? 1 : 0); }
-
-    if (fields.length > 0) {
-      values.push(id);
-      db.run(`UPDATE mcp_server_tools SET ${fields.join(", ")} WHERE id = ?`, values);
-    }
-    return this.findById(id);
-  },
-
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM mcp_server_tools WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-
-  deleteByServer(serverId: string): number {
-    const result = db.run("DELETE FROM mcp_server_tools WHERE server_id = ?", [serverId]);
-    return result.changes;
-  },
-
-  count(serverId: string): number {
-    const row = db.query("SELECT COUNT(*) as count FROM mcp_server_tools WHERE server_id = ?").get(serverId) as { count: number };
-    return row.count;
-  },
-};
-
-function rowToMcpServerTool(row: McpServerToolRow): McpServerTool {
-  let input_schema: Record<string, any> = {};
-  try { input_schema = JSON.parse(row.input_schema); } catch { /* */ }
-  let mock_response: Record<string, any> | null = null;
-  if (row.mock_response) { try { mock_response = JSON.parse(row.mock_response); } catch { /* */ } }
-  let http_config: McpServerTool["http_config"] = null;
-  if (row.http_config) { try { http_config = JSON.parse(row.http_config); } catch { /* */ } }
-
-  return {
-    id: row.id,
-    server_id: row.server_id,
-    name: row.name,
-    description: row.description,
-    input_schema,
-    handler_type: row.handler_type as McpServerTool["handler_type"],
-    mock_response,
-    http_config,
-    code: row.code,
-    enabled: row.enabled === 1,
-    created_at: row.created_at,
-  };
-}
-
-// Helper to convert DB row to McpServer type
-function rowToMcpServer(row: McpServerRow): McpServer {
-  // Decrypt env vars and headers (handles both encrypted and legacy unencrypted data)
-  const env = row.env ? decryptObject(row.env) : {};
-  const headers = row.headers ? decryptObject(row.headers) : {};
-  return {
-    id: row.id,
-    name: row.name,
-    type: row.type as McpServer["type"],
-    package: row.package,
-    pip_module: row.pip_module,
-    command: row.command,
-    args: row.args,
-    env,
-    url: row.url,
-    headers,
-    port: row.port,
-    status: row.status as "stopped" | "running",
-    source: row.source,
-    project_id: row.project_id,
-    created_at: row.created_at,
-  };
-}
-
-// Light version: skips expensive decryption of env/headers for listing endpoints
-function rowToMcpServerLight(row: McpServerRow): McpServer {
-  return {
-    id: row.id,
-    name: row.name,
-    type: row.type as McpServer["type"],
-    package: row.package,
-    pip_module: row.pip_module,
-    command: row.command,
-    args: row.args,
-    env: {},
-    url: row.url,
-    headers: {},
-    port: row.port,
-    status: row.status as "stopped" | "running",
-    source: row.source,
-    project_id: row.project_id,
-    created_at: row.created_at,
-  };
-}
-
-// Telemetry Event types
-// User types
-export interface User {
-  id: string;
-  username: string;
-  password_hash: string;
-  email: string | null; // Optional, for password recovery only
-  role: "admin" | "user";
-  created_at: string;
-  updated_at: string;
-  last_login_at: string | null;
-}
-
-export interface UserRow {
-  id: string;
-  username: string;
-  password_hash: string;
-  email: string | null;
-  role: string;
-  created_at: string;
-  updated_at: string;
-  last_login_at: string | null;
-}
-
-export interface Session {
-  id: string;
-  user_id: string;
-  refresh_token_hash: string;
-  expires_at: string;
-  created_at: string;
-}
-
-export interface SessionRow {
-  id: string;
-  user_id: string;
-  refresh_token_hash: string;
-  expires_at: string;
-  created_at: string;
-}
-
-export interface TelemetryEvent {
-  id: string;
-  agent_id: string;
-  timestamp: string;
-  category: string;
-  type: string;
-  level: string;
-  trace_id: string | null;
-  span_id: string | null;
-  thread_id: string | null;
-  data: Record<string, unknown> | null;
-  metadata: Record<string, unknown> | null;
-  duration_ms: number | null;
-  error: string | null;
-  received_at: string;
-  seen?: boolean;
-}
-
-interface TelemetryEventRow {
-  id: string;
-  agent_id: string;
-  timestamp: string;
-  category: string;
-  type: string;
-  level: string;
-  trace_id: string | null;
-  span_id: string | null;
-  thread_id: string | null;
-  data: string | null;
-  metadata: string | null;
-  duration_ms: number | null;
-  error: string | null;
-  received_at: string;
-  seen?: number;
-}
-
-// Telemetry operations
-export const TelemetryDB = {
-  // Insert batch of events
-  insertBatch(agentId: string, events: Array<{
-    id: string;
-    timestamp: string;
-    category: string;
-    type: string;
-    level: string;
-    trace_id?: string;
-    span_id?: string;
-    thread_id?: string;
-    data?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    duration_ms?: number;
-    error?: string;
-    cost?: number;
-  }>): number {
-    const now = new Date().toISOString();
-    const stmt = db.prepare(`
-      INSERT OR IGNORE INTO telemetry_events
-      (id, agent_id, timestamp, category, type, level, trace_id, span_id, thread_id, data, metadata, duration_ms, error, received_at, cost)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `);
-
-    // Wrap in transaction for massive speedup (single fsync instead of one per row)
-    let inserted = 0;
-    const insertAll = db.transaction(() => {
-      for (const event of events) {
-        const result = stmt.run(
-          event.id,
-          agentId,
-          event.timestamp,
-          event.category,
-          event.type,
-          event.level,
-          event.trace_id || null,
-          event.span_id || null,
-          event.thread_id || null,
-          event.data ? JSON.stringify(event.data) : null,
-          event.metadata ? JSON.stringify(event.metadata) : null,
-          event.duration_ms || null,
-          event.error || null,
-          now,
-          event.cost || 0
-        );
-        if (result.changes > 0) inserted++;
-      }
-    });
-    insertAll();
-    return inserted;
-  },
-
-  // Query events with filters
-  query(filters: {
-    agent_id?: string;
-    project_id?: string | null; // Filter by project (null = unassigned agents)
-    category?: string;
-    type?: string;
-    level?: string;
-    trace_id?: string;
-    since?: string;
-    until?: string;
-    limit?: number;
-    offset?: number;
-  } = {}): TelemetryEvent[] {
-    const conditions: string[] = [];
-    const params: unknown[] = [];
-
-    if (filters.agent_id) {
-      conditions.push("t.agent_id = ?");
-      params.push(filters.agent_id);
-    }
-    if (filters.project_id !== undefined) {
-      if (filters.project_id === null) {
-        conditions.push("a.project_id IS NULL");
-      } else {
-        conditions.push("a.project_id = ?");
-        params.push(filters.project_id);
-      }
-    }
-    if (filters.category) {
-      conditions.push("t.category = ?");
-      params.push(filters.category);
-    }
-    if (filters.type) {
-      conditions.push("t.type = ?");
-      params.push(filters.type);
-    }
-    if (filters.level) {
-      conditions.push("t.level = ?");
-      params.push(filters.level);
-    }
-    if (filters.trace_id) {
-      conditions.push("t.trace_id = ?");
-      params.push(filters.trace_id);
-    }
-    if (filters.since) {
-      conditions.push("t.timestamp >= ?");
-      params.push(filters.since);
-    }
-    if (filters.until) {
-      conditions.push("t.timestamp <= ?");
-      params.push(filters.until);
-    }
-
-    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    const limit = filters.limit || 100;
-    const offset = filters.offset || 0;
-
-    // Join with agents table when filtering by project
-    const needsJoin = filters.project_id !== undefined;
-    const sql = needsJoin
-      ? `SELECT t.* FROM telemetry_events t JOIN agents a ON t.agent_id = a.id ${where} ORDER BY t.timestamp DESC LIMIT ? OFFSET ?`
-      : `SELECT * FROM telemetry_events t ${where} ORDER BY t.timestamp DESC LIMIT ? OFFSET ?`;
-    params.push(limit, offset);
-
-    const rows = db.query(sql).all(...params) as TelemetryEventRow[];
-    return rows.map(rowToTelemetryEvent);
-  },
-
-  // Get usage stats
-  getUsage(filters: {
-    agent_id?: string;
-    project_id?: string | null;
-    since?: string;
-    until?: string;
-    group_by?: "agent" | "day" | "project";
-  } = {}): Array<{
-    agent_id?: string;
-    project_id?: string;
-    date?: string;
-    input_tokens: number;
-    output_tokens: number;
-    cache_creation_tokens: number;
-    cache_read_tokens: number;
-    reasoning_tokens: number;
-    llm_calls: number;
-    tool_calls: number;
-    errors: number;
-    cost: number;
-  }> {
-    const conditions: string[] = [];
-    const params: unknown[] = [];
-    const needsJoin = filters.project_id !== undefined;
-
-    if (filters.agent_id) {
-      conditions.push("t.agent_id = ?");
-      params.push(filters.agent_id);
-    }
-    if (filters.project_id !== undefined) {
-      if (filters.project_id === null) {
-        conditions.push("a.project_id IS NULL");
-      } else {
-        conditions.push("a.project_id = ?");
-        params.push(filters.project_id);
-      }
-    }
-    if (filters.since) {
-      conditions.push("t.timestamp >= ?");
-      params.push(filters.since);
-    }
-    if (filters.until) {
-      conditions.push("t.timestamp <= ?");
-      params.push(filters.until);
-    }
-
-    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-
-    let groupBy = "";
-    let selectFields = "";
-
-    if (filters.group_by === "day") {
-      groupBy = "GROUP BY date(t.timestamp)";
-      selectFields = "date(t.timestamp) as date,";
-    } else if (filters.group_by === "agent") {
-      groupBy = "GROUP BY t.agent_id";
-      selectFields = "t.agent_id as agent_id,";
-    } else if (filters.group_by === "project") {
-      groupBy = "GROUP BY a.project_id";
-      selectFields = "a.project_id as project_id,";
-    }
-
-    const needsProjectJoin = needsJoin || filters.group_by === "project";
-    const fromClause = needsProjectJoin
-      ? "FROM telemetry_events t JOIN agents a ON t.agent_id = a.id"
-      : "FROM telemetry_events t";
-
-    const sql = `
-      SELECT
-        ${selectFields}
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.input_tokens') ELSE 0 END), 0) as input_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.output_tokens') ELSE 0 END), 0) as output_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.cache_creation_tokens') ELSE 0 END), 0) as cache_creation_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.cache_read_tokens') ELSE 0 END), 0) as cache_read_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.reasoning_tokens') ELSE 0 END), 0) as reasoning_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN 1 ELSE 0 END), 0) as llm_calls,
-        COALESCE(SUM(CASE WHEN t.category = 'TOOL' THEN 1 ELSE 0 END), 0) as tool_calls,
-        COALESCE(SUM(CASE WHEN t.level = 'error' THEN 1 ELSE 0 END), 0) as errors,
-        COALESCE(SUM(t.cost), 0) as cost
-      ${fromClause}
-      ${where}
-      ${groupBy}
-    `;
-
-    return db.query(sql).all(...params) as Array<{
-      agent_id?: string;
-      project_id?: string;
-      date?: string;
-      input_tokens: number;
-      output_tokens: number;
-      cache_creation_tokens: number;
-      cache_read_tokens: number;
-      reasoning_tokens: number;
-      llm_calls: number;
-      tool_calls: number;
-      errors: number;
-      cost: number;
-    }>;
-  },
-
-  // Get summary stats
-  getStats(filters: { agentId?: string; projectId?: string | null; since?: string; until?: string } = {}): {
-    total_events: number;
-    total_llm_calls: number;
-    total_tool_calls: number;
-    total_errors: number;
-    total_input_tokens: number;
-    total_output_tokens: number;
-    total_cache_creation_tokens: number;
-    total_cache_read_tokens: number;
-    total_reasoning_tokens: number;
-    total_cost: number;
-  } {
-    const conditions: string[] = [];
-    const params: unknown[] = [];
-    const needsJoin = filters.projectId !== undefined;
-
-    if (filters.agentId) {
-      conditions.push("t.agent_id = ?");
-      params.push(filters.agentId);
-    }
-    if (filters.projectId !== undefined) {
-      if (filters.projectId === null) {
-        conditions.push("a.project_id IS NULL");
-      } else {
-        conditions.push("a.project_id = ?");
-        params.push(filters.projectId);
-      }
-    }
-    if (filters.since) {
-      conditions.push("t.timestamp >= ?");
-      params.push(filters.since);
-    }
-    if (filters.until) {
-      conditions.push("t.timestamp <= ?");
-      params.push(filters.until);
-    }
-
-    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    const fromClause = needsJoin
-      ? "FROM telemetry_events t JOIN agents a ON t.agent_id = a.id"
-      : "FROM telemetry_events t";
-
-    const sql = `
-      SELECT
-        COUNT(*) as total_events,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN 1 ELSE 0 END), 0) as total_llm_calls,
-        COALESCE(SUM(CASE WHEN t.category = 'TOOL' THEN 1 ELSE 0 END), 0) as total_tool_calls,
-        COALESCE(SUM(CASE WHEN t.level = 'error' THEN 1 ELSE 0 END), 0) as total_errors,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.input_tokens') ELSE 0 END), 0) as total_input_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.output_tokens') ELSE 0 END), 0) as total_output_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.cache_creation_tokens') ELSE 0 END), 0) as total_cache_creation_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.cache_read_tokens') ELSE 0 END), 0) as total_cache_read_tokens,
-        COALESCE(SUM(CASE WHEN t.category = 'LLM' THEN json_extract(t.data, '$.reasoning_tokens') ELSE 0 END), 0) as total_reasoning_tokens,
-        COALESCE(SUM(t.cost), 0) as total_cost
-      ${fromClause}
-      ${where}
-    `;
-
-    return db.query(sql).get(...params) as {
-      total_events: number;
-      total_llm_calls: number;
-      total_tool_calls: number;
-      total_errors: number;
-      total_input_tokens: number;
-      total_output_tokens: number;
-      total_cache_creation_tokens: number;
-      total_cache_read_tokens: number;
-      total_reasoning_tokens: number;
-      total_cost: number;
-    };
-  },
-
-  // Delete old events (retention)
-  deleteOlderThan(days: number): number {
-    const cutoff = new Date();
-    cutoff.setDate(cutoff.getDate() - days);
-    const result = db.run(
-      "DELETE FROM telemetry_events WHERE timestamp < ?",
-      [cutoff.toISOString()]
-    );
-    return result.changes;
-  },
-
-  // Delete all events for an agent
-  deleteByAgent(agentId: string): number {
-    const result = db.run(
-      "DELETE FROM telemetry_events WHERE agent_id = ?",
-      [agentId]
-    );
-    return result.changes;
-  },
-
-  // Count events
-  count(agentId?: string): number {
-    if (agentId) {
-      const row = db.query("SELECT COUNT(*) as count FROM telemetry_events WHERE agent_id = ?").get(agentId) as { count: number };
-      return row.count;
-    }
-    const row = db.query("SELECT COUNT(*) as count FROM telemetry_events").get() as { count: number };
-    return row.count;
-  },
-
-  // --- Notification helpers (piggyback on telemetry with `seen` flag) ---
-
-  // Notification-worthy filter: errors + agent crashes
-  getNotifications(limit = 50): TelemetryEvent[] {
-    const rows = db.query(`
-      SELECT * FROM telemetry_events
-      WHERE (level = 'error' OR (category = 'system' AND type = 'agent_stopped') OR category = 'ERROR')
-      ORDER BY timestamp DESC
-      LIMIT ?
-    `).all(limit) as TelemetryEventRow[];
-    return rows.map(rowToTelemetryEvent);
-  },
-
-  getUnseenCount(): number {
-    const row = db.query(`
-      SELECT COUNT(*) as count FROM telemetry_events
-      WHERE seen = 0
-        AND (level = 'error' OR (category = 'system' AND type = 'agent_stopped') OR category = 'ERROR')
-    `).get() as { count: number };
-    return row.count;
-  },
-
-  markSeen(ids: string[]): number {
-    if (ids.length === 0) return 0;
-    const placeholders = ids.map(() => "?").join(",");
-    const result = db.run(
-      `UPDATE telemetry_events SET seen = 1 WHERE id IN (${placeholders})`,
-      ids
-    );
-    return result.changes;
-  },
-
-  markAllSeen(): number {
-    const result = db.run(
-      `UPDATE telemetry_events SET seen = 1 WHERE seen = 0 AND (level = 'error' OR (category = 'system' AND type = 'agent_stopped') OR category = 'ERROR')`
-    );
-    return result.changes;
-  },
-};
-
-function rowToTelemetryEvent(row: TelemetryEventRow): TelemetryEvent {
-  return {
-    id: row.id,
-    agent_id: row.agent_id,
-    timestamp: row.timestamp,
-    category: row.category,
-    type: row.type,
-    level: row.level,
-    trace_id: row.trace_id,
-    span_id: row.span_id,
-    thread_id: row.thread_id,
-    data: row.data ? JSON.parse(row.data) : null,
-    metadata: row.metadata ? JSON.parse(row.metadata) : null,
-    duration_ms: row.duration_ms,
-    error: row.error,
-    received_at: row.received_at,
-    seen: row.seen === 1,
-  };
-}
-
-// User operations
-export const UserDB = {
-  // Create a new user
-  create(user: { username: string; password_hash: string; email?: string | null; role?: "admin" | "user" }): User {
-    const id = generateId();
-    const now = new Date().toISOString();
-    const role = user.role || "user";
-
-    db.run(
-      `INSERT INTO users (id, username, password_hash, email, role, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?)`,
-      [id, user.username.toLowerCase(), user.password_hash, user.email || null, role, now, now]
-    );
-
-    return this.findById(id)!;
-  },
-
-  // Find user by ID
-  findById(id: string): User | null {
-    const row = db.query("SELECT * FROM users WHERE id = ?").get(id) as UserRow | null;
-    return row ? rowToUser(row) : null;
-  },
-
-  // Find user by username
-  findByUsername(username: string): User | null {
-    const row = db.query("SELECT * FROM users WHERE username = ?").get(username.toLowerCase()) as UserRow | null;
-    return row ? rowToUser(row) : null;
-  },
-
-  // Find user by email (for password recovery)
-  findByEmail(email: string): User | null {
-    const row = db.query("SELECT * FROM users WHERE email = ?").get(email.toLowerCase()) as UserRow | null;
-    return row ? rowToUser(row) : null;
-  },
-
-  // Get all users
-  findAll(): User[] {
-    const rows = db.query("SELECT * FROM users ORDER BY created_at DESC").all() as UserRow[];
-    return rows.map(rowToUser);
-  },
-
-  // Update user
-  update(id: string, updates: Partial<Omit<User, "id" | "created_at">>): User | null {
-    const user = this.findById(id);
-    if (!user) return null;
-
-    const fields: string[] = [];
-    const values: unknown[] = [];
-
-    if (updates.username !== undefined) {
-      fields.push("username = ?");
-      values.push(updates.username.toLowerCase());
-    }
-    if (updates.password_hash !== undefined) {
-      fields.push("password_hash = ?");
-      values.push(updates.password_hash);
-    }
-    if (updates.email !== undefined) {
-      fields.push("email = ?");
-      values.push(updates.email);
-    }
-    if (updates.role !== undefined) {
-      fields.push("role = ?");
-      values.push(updates.role);
-    }
-    if (updates.last_login_at !== undefined) {
-      fields.push("last_login_at = ?");
-      values.push(updates.last_login_at);
-    }
-
-    if (fields.length > 0) {
-      fields.push("updated_at = ?");
-      values.push(new Date().toISOString());
-      values.push(id);
-
-      db.run(`UPDATE users SET ${fields.join(", ")} WHERE id = ?`, values);
-    }
-
-    return this.findById(id);
-  },
-
-  // Delete user
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM users WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-
-  // Update last login
-  updateLastLogin(id: string): void {
-    db.run("UPDATE users SET last_login_at = ? WHERE id = ?", [new Date().toISOString(), id]);
-  },
-
-  // Count users
-  count(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM users").get() as { count: number };
-    return row.count;
-  },
-
-  // Check if any users exist
-  hasUsers(): boolean {
-    return this.count() > 0;
-  },
-
-  // Count admins
-  countAdmins(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM users WHERE role = 'admin'").get() as { count: number };
-    return row.count;
-  },
-};
-
-// Helper to convert DB row to User type
-function rowToUser(row: UserRow): User {
-  return {
-    id: row.id,
-    username: row.username,
-    password_hash: row.password_hash,
-    email: row.email,
-    role: row.role as "admin" | "user",
-    created_at: row.created_at,
-    updated_at: row.updated_at,
-    last_login_at: row.last_login_at,
-  };
-}
-
-// Session operations
-export const SessionDB = {
-  // Create a new session
-  create(session: { user_id: string; refresh_token_hash: string; expires_at: string }): Session {
-    const id = generateId();
-    const now = new Date().toISOString();
-
-    db.run(
-      `INSERT INTO sessions (id, user_id, refresh_token_hash, expires_at, created_at)
-       VALUES (?, ?, ?, ?, ?)`,
-      [id, session.user_id, session.refresh_token_hash, session.expires_at, now]
-    );
-
-    return this.findById(id)!;
-  },
-
-  // Find session by ID
-  findById(id: string): Session | null {
-    const row = db.query("SELECT * FROM sessions WHERE id = ?").get(id) as SessionRow | null;
-    return row ? rowToSession(row) : null;
-  },
-
-  // Find session by refresh token hash
-  findByTokenHash(tokenHash: string): Session | null {
-    const row = db.query("SELECT * FROM sessions WHERE refresh_token_hash = ?").get(tokenHash) as SessionRow | null;
-    return row ? rowToSession(row) : null;
-  },
-
-  // Get all sessions for a user
-  findByUser(userId: string): Session[] {
-    const rows = db.query("SELECT * FROM sessions WHERE user_id = ? ORDER BY created_at DESC").all(userId) as SessionRow[];
-    return rows.map(rowToSession);
-  },
-
-  // Delete session
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM sessions WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-
-  // Delete session by token hash
-  deleteByTokenHash(tokenHash: string): boolean {
-    const result = db.run("DELETE FROM sessions WHERE refresh_token_hash = ?", [tokenHash]);
-    return result.changes > 0;
-  },
-
-  // Delete all sessions for a user
-  deleteByUser(userId: string): number {
-    const result = db.run("DELETE FROM sessions WHERE user_id = ?", [userId]);
-    return result.changes;
-  },
-
-  // Delete expired sessions
-  deleteExpired(): number {
-    const result = db.run("DELETE FROM sessions WHERE expires_at < ?", [new Date().toISOString()]);
-    return result.changes;
-  },
-
-  // Check if session is valid (exists and not expired)
-  isValid(id: string): boolean {
-    const session = this.findById(id);
-    if (!session) return false;
-    return new Date(session.expires_at) > new Date();
-  },
-};
-
-// Helper to convert DB row to Session type
-function rowToSession(row: SessionRow): Session {
-  return {
-    id: row.id,
-    user_id: row.user_id,
-    refresh_token_hash: row.refresh_token_hash,
-    expires_at: row.expires_at,
-    created_at: row.created_at,
-  };
-}
-
-// API Key types
-export interface ApiKey {
-  id: string;
-  name: string;
-  key_hash: string;
-  key_prefix: string;
-  user_id: string;
-  expires_at: string | null;
-  last_used_at: string | null;
-  is_active: boolean;
-  created_at: string;
-}
-
-interface ApiKeyRow {
-  id: string;
-  name: string;
-  key_hash: string;
-  key_prefix: string;
-  user_id: string;
-  expires_at: string | null;
-  last_used_at: string | null;
-  is_active: number;
-  created_at: string;
-}
-
-function rowToApiKey(row: ApiKeyRow): ApiKey {
-  return {
-    id: row.id,
-    name: row.name,
-    key_hash: row.key_hash,
-    key_prefix: row.key_prefix,
-    user_id: row.user_id,
-    expires_at: row.expires_at,
-    last_used_at: row.last_used_at,
-    is_active: row.is_active === 1,
-    created_at: row.created_at,
-  };
-}
-
-// API Key operations
-export const ApiKeyDB = {
-  // Create a new API key (returns the raw key only at creation time)
-  create(data: { name: string; user_id: string; expires_at?: string | null }): { apiKey: ApiKey; rawKey: string } {
-    const id = generateId();
-    const rawKey = `apt_${randomBytes(24).toString("hex")}`;
-    const keyHash = createHash("sha256").update(rawKey).digest("hex");
-    const keyPrefix = rawKey.slice(0, 10);
-    const now = new Date().toISOString();
-
-    db.run(
-      `INSERT INTO api_keys (id, name, key_hash, key_prefix, user_id, expires_at, created_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?)`,
-      [id, data.name, keyHash, keyPrefix, data.user_id, data.expires_at || null, now]
-    );
-
-    return { apiKey: this.findById(id)!, rawKey };
-  },
-
-  // Find by ID
-  findById(id: string): ApiKey | null {
-    const row = db.query("SELECT * FROM api_keys WHERE id = ?").get(id) as ApiKeyRow | null;
-    return row ? rowToApiKey(row) : null;
-  },
-
-  // Validate a raw key - returns the API key record and user if valid
-  validate(rawKey: string): { apiKey: ApiKey; user: User } | null {
-    const keyHash = createHash("sha256").update(rawKey).digest("hex");
-    const row = db.query(
-      "SELECT * FROM api_keys WHERE key_hash = ? AND is_active = 1"
-    ).get(keyHash) as ApiKeyRow | null;
-
-    if (!row) return null;
-
-    const apiKey = rowToApiKey(row);
-
-    // Check expiration
-    if (apiKey.expires_at && new Date(apiKey.expires_at) < new Date()) {
-      return null;
-    }
-
-    // Load the user
-    const user = UserDB.findById(apiKey.user_id);
-    if (!user) return null;
-
-    // Update last_used_at
-    db.run("UPDATE api_keys SET last_used_at = ? WHERE id = ?", [new Date().toISOString(), apiKey.id]);
-
-    return { apiKey, user };
-  },
-
-  // List all keys for a user (does not expose hash)
-  findByUser(userId: string): ApiKey[] {
-    const rows = db.query(
-      "SELECT * FROM api_keys WHERE user_id = ? ORDER BY created_at DESC"
-    ).all(userId) as ApiKeyRow[];
-    return rows.map(rowToApiKey);
-  },
-
-  // Revoke a key
-  revoke(id: string, userId: string): boolean {
-    const result = db.run(
-      "UPDATE api_keys SET is_active = 0 WHERE id = ? AND user_id = ?",
-      [id, userId]
-    );
-    return result.changes > 0;
-  },
-
-  // Delete a key
-  delete(id: string, userId: string): boolean {
-    const result = db.run(
-      "DELETE FROM api_keys WHERE id = ? AND user_id = ?",
-      [id, userId]
-    );
-    return result.changes > 0;
-  },
-
-  // Count active keys for a user
-  countByUser(userId: string): number {
-    const row = db.query(
-      "SELECT COUNT(*) as count FROM api_keys WHERE user_id = ? AND is_active = 1"
-    ).get(userId) as { count: number };
-    return row.count;
-  },
-};
-
-// Skill operations
-export const SkillDB = {
-  // Create a new skill
-  create(skill: Omit<Skill, "id" | "created_at" | "updated_at">): Skill {
-    const id = generateId();
-    const now = new Date().toISOString();
-    const metadataJson = JSON.stringify(skill.metadata || {});
-    const allowedToolsJson = JSON.stringify(skill.allowed_tools || []);
-
-    db.run(
-      `INSERT INTO skills (id, name, description, content, version, license, compatibility, metadata, allowed_tools, source, source_url, enabled, project_id, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-      [
-        id,
-        skill.name,
-        skill.description,
-        skill.content,
-        skill.version || "1.0.0",
-        skill.license || null,
-        skill.compatibility || null,
-        metadataJson,
-        allowedToolsJson,
-        skill.source,
-        skill.source_url || null,
-        skill.enabled ? 1 : 0,
-        skill.project_id || null,
-        now,
-        now,
-      ]
-    );
-
-    return this.findById(id)!;
-  },
-
-  // Find skill by ID
-  findById(id: string): Skill | null {
-    const row = db.query("SELECT * FROM skills WHERE id = ?").get(id) as SkillRow | null;
-    return row ? rowToSkill(row) : null;
-  },
-
-  findByIds(ids: string[]): Map<string, Skill> {
-    if (ids.length === 0) return new Map();
-    const placeholders = ids.map(() => "?").join(",");
-    const rows = db.query(`SELECT * FROM skills WHERE id IN (${placeholders})`).all(...ids) as SkillRow[];
-    const map = new Map<string, Skill>();
-    for (const row of rows) map.set(row.id, rowToSkill(row));
-    return map;
-  },
-
-  // Find skill by name
-  findByName(name: string): Skill | null {
-    const row = db.query("SELECT * FROM skills WHERE name = ?").get(name) as SkillRow | null;
-    return row ? rowToSkill(row) : null;
-  },
-
-  // Check if skill exists by name
-  exists(name: string): boolean {
-    const row = db.query("SELECT 1 FROM skills WHERE name = ?").get(name);
-    return row !== null;
-  },
-
-  // Get all skills
-  findAll(): Skill[] {
-    const rows = db.query("SELECT * FROM skills ORDER BY name ASC").all() as SkillRow[];
-    return rows.map(rowToSkill);
-  },
-
-  // Get enabled skills
-  findEnabled(): Skill[] {
-    const rows = db.query("SELECT * FROM skills WHERE enabled = 1 ORDER BY name ASC").all() as SkillRow[];
-    return rows.map(rowToSkill);
-  },
-
-  // Update skill
-  update(id: string, updates: Partial<Omit<Skill, "id" | "created_at">>): Skill | null {
-    const skill = this.findById(id);
-    if (!skill) return null;
-
-    const fields: string[] = [];
-    const values: unknown[] = [];
-
-    if (updates.name !== undefined) {
-      fields.push("name = ?");
-      values.push(updates.name);
-    }
-    if (updates.description !== undefined) {
-      fields.push("description = ?");
-      values.push(updates.description);
-    }
-    if (updates.content !== undefined) {
-      fields.push("content = ?");
-      values.push(updates.content);
-    }
-    if (updates.version !== undefined) {
-      fields.push("version = ?");
-      values.push(updates.version);
-    }
-    if (updates.license !== undefined) {
-      fields.push("license = ?");
-      values.push(updates.license);
-    }
-    if (updates.compatibility !== undefined) {
-      fields.push("compatibility = ?");
-      values.push(updates.compatibility);
-    }
-    if (updates.metadata !== undefined) {
-      fields.push("metadata = ?");
-      values.push(JSON.stringify(updates.metadata));
-    }
-    if (updates.allowed_tools !== undefined) {
-      fields.push("allowed_tools = ?");
-      values.push(JSON.stringify(updates.allowed_tools));
-    }
-    if (updates.source !== undefined) {
-      fields.push("source = ?");
-      values.push(updates.source);
-    }
-    if (updates.source_url !== undefined) {
-      fields.push("source_url = ?");
-      values.push(updates.source_url);
-    }
-    if (updates.enabled !== undefined) {
-      fields.push("enabled = ?");
-      values.push(updates.enabled ? 1 : 0);
-    }
-    if (updates.project_id !== undefined) {
-      fields.push("project_id = ?");
-      values.push(updates.project_id);
-    }
-
-    if (fields.length > 0) {
-      fields.push("updated_at = ?");
-      values.push(new Date().toISOString());
-      values.push(id);
-
-      db.run(`UPDATE skills SET ${fields.join(", ")} WHERE id = ?`, values);
-    }
-
-    return this.findById(id);
-  },
-
-  // Toggle skill enabled/disabled
-  setEnabled(id: string, enabled: boolean): Skill | null {
-    return this.update(id, { enabled });
-  },
-
-  // Delete skill
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM skills WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-
-  // Count skills
-  count(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM skills").get() as { count: number };
-    return row.count;
-  },
-
-  // Count enabled skills
-  countEnabled(): number {
-    const row = db.query("SELECT COUNT(*) as count FROM skills WHERE enabled = 1").get() as { count: number };
-    return row.count;
-  },
-
-  // Find skills by project (null = global only)
-  findByProject(projectId: string | null): Skill[] {
-    if (projectId === null) {
-      const rows = db.query("SELECT * FROM skills WHERE project_id IS NULL ORDER BY name ASC").all() as SkillRow[];
-      return rows.map(rowToSkill);
-    }
-    const rows = db.query("SELECT * FROM skills WHERE project_id = ? ORDER BY name ASC").all(projectId) as SkillRow[];
-    return rows.map(rowToSkill);
-  },
-
-  // Find skills available for an agent (global + agent's project)
-  findForAgent(agentProjectId: string | null): Skill[] {
-    if (agentProjectId === null) {
-      // Agent has no project, only show global skills
-      const rows = db.query("SELECT * FROM skills WHERE project_id IS NULL ORDER BY name ASC").all() as SkillRow[];
-      return rows.map(rowToSkill);
-    }
-    // Agent has a project, show global + project skills
-    const rows = db.query("SELECT * FROM skills WHERE project_id IS NULL OR project_id = ? ORDER BY name ASC").all(agentProjectId) as SkillRow[];
-    return rows.map(rowToSkill);
-  },
-
-  // Find global skills only
-  findGlobal(): Skill[] {
-    const rows = db.query("SELECT * FROM skills WHERE project_id IS NULL ORDER BY name ASC").all() as SkillRow[];
-    return rows.map(rowToSkill);
-  },
-};
-
-// Helper to convert DB row to Skill type
-function rowToSkill(row: SkillRow): Skill {
-  let metadata: Record<string, string> = {};
-  if (row.metadata) {
-    try {
-      metadata = JSON.parse(row.metadata);
-    } catch {
-      // Use empty object if parsing fails
-    }
-  }
-  let allowed_tools: string[] = [];
-  if (row.allowed_tools) {
-    try {
-      allowed_tools = JSON.parse(row.allowed_tools);
-    } catch {
-      // Use empty array if parsing fails
-    }
-  }
-  return {
-    id: row.id,
-    name: row.name,
-    description: row.description,
-    content: row.content,
-    version: row.version || "1.0.0",
-    license: row.license,
-    compatibility: row.compatibility,
-    metadata,
-    allowed_tools,
-    source: row.source as Skill["source"],
-    source_url: row.source_url,
-    enabled: row.enabled === 1,
-    project_id: row.project_id,
-    created_at: row.created_at,
-    updated_at: row.updated_at,
-  };
-}
-
-// Subscription row → Subscription
-function rowToSubscription(row: SubscriptionRow): Subscription {
-  return {
-    id: row.id,
-    trigger_slug: row.trigger_slug,
-    trigger_instance_id: row.trigger_instance_id,
-    agent_id: row.agent_id,
-    enabled: row.enabled === 1,
-    project_id: row.project_id,
-    created_at: row.created_at,
-    updated_at: row.updated_at,
-  };
-}
-
-export const SubscriptionDB = {
-  create(sub: Omit<Subscription, "id" | "created_at" | "updated_at">): Subscription {
-    const id = generateId();
-    const now = new Date().toISOString();
-    db.run(
-      `INSERT INTO subscriptions (id, trigger_slug, trigger_instance_id, agent_id, enabled, project_id, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
-      [id, sub.trigger_slug, sub.trigger_instance_id || null, sub.agent_id, sub.enabled ? 1 : 0, sub.project_id || null, now, now]
-    );
-    return this.findById(id)!;
-  },
-
-  findById(id: string): Subscription | null {
-    const row = db.query("SELECT * FROM subscriptions WHERE id = ?").get(id) as SubscriptionRow | null;
-    return row ? rowToSubscription(row) : null;
-  },
-
-  findByTriggerInstanceId(instanceId: string): Subscription[] {
-    const rows = db.query("SELECT * FROM subscriptions WHERE trigger_instance_id = ?").all(instanceId) as SubscriptionRow[];
-    return rows.map(rowToSubscription);
-  },
-
-  findByTriggerSlug(slug: string): Subscription[] {
-    const rows = db.query("SELECT * FROM subscriptions WHERE trigger_slug = ?").all(slug) as SubscriptionRow[];
-    return rows.map(rowToSubscription);
-  },
-
-  findByAgentId(agentId: string): Subscription[] {
-    const rows = db.query("SELECT * FROM subscriptions WHERE agent_id = ?").all(agentId) as SubscriptionRow[];
-    return rows.map(rowToSubscription);
-  },
-
-  // Batch load subscriptions for multiple agents (1 query instead of N)
-  findByAgentIds(agentIds: string[]): Map<string, Subscription[]> {
-    const result = new Map<string, Subscription[]>();
-    if (agentIds.length === 0) return result;
-    const placeholders = agentIds.map(() => "?").join(",");
-    const rows = db.query(`SELECT * FROM subscriptions WHERE agent_id IN (${placeholders})`).all(...agentIds) as SubscriptionRow[];
-    for (const row of rows) {
-      const sub = rowToSubscription(row);
-      const list = result.get(sub.agent_id) || [];
-      list.push(sub);
-      result.set(sub.agent_id, list);
-    }
-    return result;
-  },
-
-  findAll(projectId?: string | null): Subscription[] {
-    if (projectId) {
-      const rows = db.query("SELECT * FROM subscriptions WHERE project_id = ? ORDER BY created_at DESC").all(projectId) as SubscriptionRow[];
-      return rows.map(rowToSubscription);
-    }
-    const rows = db.query("SELECT * FROM subscriptions ORDER BY created_at DESC").all() as SubscriptionRow[];
-    return rows.map(rowToSubscription);
-  },
-
-  update(id: string, updates: Partial<Pick<Subscription, "trigger_slug" | "trigger_instance_id" | "agent_id" | "enabled">>): Subscription | null {
-    const sub = this.findById(id);
-    if (!sub) return null;
-
-    const fields: string[] = [];
-    const values: (string | number | null)[] = [];
-
-    if (updates.trigger_slug !== undefined) { fields.push("trigger_slug = ?"); values.push(updates.trigger_slug); }
-    if (updates.trigger_instance_id !== undefined) { fields.push("trigger_instance_id = ?"); values.push(updates.trigger_instance_id || null); }
-    if (updates.agent_id !== undefined) { fields.push("agent_id = ?"); values.push(updates.agent_id); }
-    if (updates.enabled !== undefined) { fields.push("enabled = ?"); values.push(updates.enabled ? 1 : 0); }
-
-    if (fields.length === 0) return sub;
-
-    fields.push("updated_at = ?");
-    values.push(new Date().toISOString());
-    values.push(id);
-
-    db.run(`UPDATE subscriptions SET ${fields.join(", ")} WHERE id = ?`, values);
-    return this.findById(id);
-  },
-
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM subscriptions WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-};
-
-// --- Channel DB ---
-
-function rowToChannel(row: ChannelRow): Channel {
-  return {
-    id: row.id,
-    type: row.type as Channel["type"],
-    name: row.name,
-    agent_id: row.agent_id,
-    config: row.config,
-    status: row.status as Channel["status"],
-    error: row.error,
-    project_id: row.project_id,
-    created_at: row.created_at,
-    updated_at: row.updated_at,
-  };
-}
-
-export const ChannelDB = {
-  create(channel: { type: string; name: string; agent_id: string; config: string; project_id?: string | null }): Channel {
-    const id = generateId();
-    const now = new Date().toISOString();
-    db.run(
-      `INSERT INTO channels (id, type, name, agent_id, config, status, project_id, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, 'stopped', ?, ?, ?)`,
-      [id, channel.type, channel.name, channel.agent_id, channel.config, channel.project_id || null, now, now]
-    );
-    return this.findById(id)!;
-  },
-
-  findById(id: string): Channel | null {
-    const row = db.query("SELECT * FROM channels WHERE id = ?").get(id) as ChannelRow | null;
-    return row ? rowToChannel(row) : null;
-  },
-
-  findAll(): Channel[] {
-    const rows = db.query("SELECT * FROM channels ORDER BY created_at DESC").all() as ChannelRow[];
-    return rows.map(rowToChannel);
-  },
-
-  findByAgentId(agentId: string): Channel[] {
-    const rows = db.query("SELECT * FROM channels WHERE agent_id = ?").all(agentId) as ChannelRow[];
-    return rows.map(rowToChannel);
-  },
-
-  findRunning(): Channel[] {
-    const rows = db.query("SELECT * FROM channels WHERE status = 'running'").all() as ChannelRow[];
-    return rows.map(rowToChannel);
-  },
-
-  update(id: string, updates: { name?: string; agent_id?: string; config?: string; project_id?: string | null }): Channel | null {
-    const channel = this.findById(id);
-    if (!channel) return null;
-
-    const fields: string[] = [];
-    const values: (string | null)[] = [];
-
-    if (updates.name !== undefined) { fields.push("name = ?"); values.push(updates.name); }
-    if (updates.agent_id !== undefined) { fields.push("agent_id = ?"); values.push(updates.agent_id); }
-    if (updates.config !== undefined) { fields.push("config = ?"); values.push(updates.config); }
-    if (updates.project_id !== undefined) { fields.push("project_id = ?"); values.push(updates.project_id || null); }
-
-    if (fields.length === 0) return channel;
-
-    fields.push("updated_at = ?");
-    values.push(new Date().toISOString());
-    values.push(id);
-
-    db.run(`UPDATE channels SET ${fields.join(", ")} WHERE id = ?`, values);
-    return this.findById(id);
-  },
-
-  setStatus(id: string, status: Channel["status"], error?: string | null): void {
-    db.run(
-      "UPDATE channels SET status = ?, error = ?, updated_at = ? WHERE id = ?",
-      [status, error || null, new Date().toISOString(), id]
-    );
-  },
-
-  delete(id: string): boolean {
-    const result = db.run("DELETE FROM channels WHERE id = ?", [id]);
-    return result.changes > 0;
-  },
-};
-
-// Generate unique ID
-export function generateId(): string {
-  return Math.random().toString(36).substring(2, 15);
-}