@conversionpros/aiva 1.0.0

package/router-db.js

@@ -0,0 +1,604 @@
+const { DatabaseSync } = require('node:sqlite');
+const path = require('path');
+
+const DB_PATH = path.join(process.env.HOME, '.openclaw', 'workspace', 'message-router', 'router.db');
+const db = new DatabaseSync(DB_PATH);
+
+db.exec(`PRAGMA journal_mode = WAL`);
+db.exec(`PRAGMA foreign_keys = ON`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS contact_rules (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    phone TEXT UNIQUE NOT NULL,
+    name TEXT NOT NULL DEFAULT 'Unknown',
+    category TEXT NOT NULL DEFAULT 'unknown',
+    response_mode TEXT NOT NULL DEFAULT 'escalate',
+    style TEXT NOT NULL DEFAULT 'casual',
+    context TEXT DEFAULT '',
+    instructions TEXT DEFAULT '',
+    priority TEXT NOT NULL DEFAULT 'normal',
+    created_at DATETIME DEFAULT (datetime('now')),
+    updated_at DATETIME DEFAULT (datetime('now'))
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS message_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    phone TEXT NOT NULL,
+    direction TEXT NOT NULL DEFAULT 'inbound',
+    message_preview TEXT DEFAULT '',
+    rules_applied TEXT DEFAULT '{}',
+    forwarded_to TEXT DEFAULT '',
+    timestamp DATETIME DEFAULT (datetime('now'))
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS contact_context (
+    phone TEXT PRIMARY KEY,
+    name TEXT,
+    relationship TEXT DEFAULT '',
+    last_topic TEXT DEFAULT '',
+    pending_items TEXT DEFAULT '[]',
+    preferences_learned TEXT DEFAULT '{}',
+    conversation_summary TEXT DEFAULT '',
+    last_interaction TEXT,
+    updated_at TEXT DEFAULT (datetime('now'))
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS pending_requests (
+    request_id TEXT PRIMARY KEY,
+    phone TEXT NOT NULL,
+    type TEXT NOT NULL,
+    conversation_context TEXT DEFAULT '',
+    status TEXT NOT NULL DEFAULT 'waiting',
+    request_data TEXT DEFAULT '{}',
+    response_data TEXT DEFAULT '{}',
+    created_at TEXT DEFAULT (datetime('now')),
+    resolved_at TEXT
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS settings (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS escalation_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    phone TEXT NOT NULL,
+    type TEXT NOT NULL,
+    details_hash TEXT NOT NULL,
+    details_text TEXT DEFAULT '',
+    created_at TEXT DEFAULT (datetime('now'))
+  )
+`);
+db.exec(`
+  CREATE TABLE IF NOT EXISTS monitoring_sessions (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    active INTEGER NOT NULL DEFAULT 0,
+    reason TEXT DEFAULT '',
+    auto INTEGER NOT NULL DEFAULT 0,
+    started_at TEXT DEFAULT (datetime('now')),
+    ended_at TEXT
+  )
+`);
+try { db.exec(`ALTER TABLE monitoring_sessions ADD COLUMN auto INTEGER NOT NULL DEFAULT 0`); } catch(e) {}
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS monitoring_introductions (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id INTEGER NOT NULL,
+    phone TEXT NOT NULL,
+    introduced_at TEXT DEFAULT (datetime('now'))
+  )
+`);
+try { db.exec(`CREATE INDEX idx_monitoring_intro_session_phone ON monitoring_introductions(session_id, phone)`); } catch(e) {}
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS escalations (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    code TEXT UNIQUE NOT NULL,
+    phone TEXT NOT NULL,
+    contact_name TEXT,
+    message_text TEXT,
+    created_at DATETIME DEFAULT (datetime('now')),
+    expires_at DATETIME,
+    status TEXT DEFAULT 'pending',
+    response_instructions TEXT,
+    ai_response TEXT,
+    responded_at DATETIME
+  )
+`);
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_escalations_code ON escalations(code)`); } catch(e) {}
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_escalations_status ON escalations(status)`); } catch(e) {}
+try { db.exec(`ALTER TABLE escalations ADD COLUMN token TEXT`); } catch(e) {}
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_escalations_token ON escalations(token)`); } catch(e) {}
+
+try { db.exec(`CREATE INDEX idx_escalation_phone_type ON escalation_log(phone, type)`); } catch(e) {}
+
+try { db.exec(`ALTER TABLE contact_rules ADD COLUMN aiva_introduced INTEGER DEFAULT 0`); } catch(e) {}
+try { db.exec(`ALTER TABLE contact_rules ADD COLUMN source TEXT DEFAULT 'unknown'`); } catch(e) {}
+try { db.exec(`ALTER TABLE message_log ADD COLUMN source TEXT DEFAULT ''`); } catch(e) {}
+
+// One-time migration: tag existing contacts by source
+try {
+  const unknownContacts = db.prepare("SELECT phone FROM contact_rules WHERE source IS NULL OR source = 'unknown' OR source = ''").all();
+  for (const c of unknownContacts) {
+    const waMsg = db.prepare("SELECT 1 FROM message_log WHERE phone = ? AND (rules_applied LIKE '%whatsapp%' OR source = 'whatsapp') LIMIT 1").get(c.phone);
+    if (waMsg) {
+      db.prepare("UPDATE contact_rules SET source = 'whatsapp' WHERE phone = ?").run(c.phone);
+    } else {
+      db.prepare("UPDATE contact_rules SET source = 'imessage' WHERE phone = ?").run(c.phone);
+    }
+  }
+} catch(e) { console.log('Source migration error:', e.message); }
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS scheduling_rules (
+    category TEXT PRIMARY KEY,
+    rule_preset TEXT DEFAULT 'flexible',
+    custom_instructions TEXT DEFAULT '',
+    structured_overrides TEXT DEFAULT '{}',
+    updated_at TEXT DEFAULT (datetime('now'))
+  )
+`);
+// Migration: add structured_overrides column if missing
+try { db.exec("ALTER TABLE scheduling_rules ADD COLUMN structured_overrides TEXT DEFAULT '{}'"); } catch(e) { /* already exists */ }
+db.exec(`INSERT OR IGNORE INTO scheduling_rules (category, rule_preset) VALUES ('family', 'flexible')`);
+db.exec(`INSERT OR IGNORE INTO scheduling_rules (category, rule_preset) VALUES ('team', 'work-hours')`);
+db.exec(`INSERT OR IGNORE INTO scheduling_rules (category, rule_preset) VALUES ('client', 'professional')`);
+db.exec(`INSERT OR IGNORE INTO scheduling_rules (category, rule_preset) VALUES ('unknown', 'gatekeeper')`);
+db.exec(`INSERT OR IGNORE INTO scheduling_rules (category, rule_preset) VALUES ('owner', 'flexible')`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS group_chats (
+    chat_guid TEXT PRIMARY KEY,
+    name TEXT DEFAULT '',
+    purpose TEXT DEFAULT '',
+    response_mode TEXT DEFAULT 'mentioned-only',
+    personality TEXT DEFAULT 'casual',
+    custom_instructions TEXT DEFAULT '',
+    enabled INTEGER DEFAULT 1,
+    created_at TEXT DEFAULT (datetime('now')),
+    updated_at TEXT DEFAULT (datetime('now'))
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS group_chat_context (
+    chat_guid TEXT PRIMARY KEY,
+    last_topic TEXT DEFAULT '',
+    conversation_summary TEXT DEFAULT '',
+    updated_at TEXT DEFAULT (datetime('now'))
+  )
+`);
+
+// Group participants tracking
+db.exec(`
+  CREATE TABLE IF NOT EXISTS group_participants (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    chat_guid TEXT NOT NULL,
+    phone TEXT NOT NULL,
+    display_name TEXT DEFAULT '',
+    first_seen TEXT DEFAULT (datetime('now')),
+    last_seen TEXT DEFAULT (datetime('now')),
+    UNIQUE(chat_guid, phone)
+  )
+`);
+try { db.exec(`CREATE INDEX idx_group_participants_chat ON group_participants(chat_guid)`); } catch(e) {}
+try { db.exec(`CREATE INDEX idx_group_participants_phone ON group_participants(phone)`); } catch(e) {}
+
+// Add columns to group_chats for escalation tracking
+try { db.exec(`ALTER TABLE group_chats ADD COLUMN participants TEXT DEFAULT '[]'`); } catch(e) {}
+try { db.exec(`ALTER TABLE group_chats ADD COLUMN detected_at TEXT DEFAULT (datetime('now'))`); } catch(e) {}
+try { db.exec(`ALTER TABLE group_chats ADD COLUMN owner_notified INTEGER DEFAULT 0`); } catch(e) {}
+try { db.exec(`ALTER TABLE group_chats ADD COLUMN escalation_code TEXT DEFAULT ''`); } catch(e) {}
+try { db.exec(`ALTER TABLE group_chats ADD COLUMN nickname TEXT DEFAULT ''`); } catch(e) {}
+try { db.exec(`ALTER TABLE group_chats ADD COLUMN context_notes TEXT DEFAULT ''`); } catch(e) {}
+
+// ── Email Router Tables ──────────────────────────────────
+db.exec(`
+  CREATE TABLE IF NOT EXISTS email_rules (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    email TEXT,
+    domain TEXT,
+    sender_name TEXT,
+    action TEXT NOT NULL DEFAULT 'surface',
+    instructions TEXT DEFAULT '',
+    auto_respond_template TEXT DEFAULT '',
+    auto_respond_mode TEXT DEFAULT 'once',
+    created_at DATETIME DEFAULT (datetime('now')),
+    updated_at DATETIME DEFAULT (datetime('now'))
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS email_drafts (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    gmail_id TEXT,
+    account TEXT,
+    from_email TEXT,
+    from_name TEXT,
+    to_email TEXT,
+    subject TEXT,
+    body_text TEXT,
+    body_html TEXT,
+    ai_draft TEXT,
+    status TEXT DEFAULT 'pending',
+    action_taken TEXT,
+    rule_id INTEGER,
+    created_at DATETIME DEFAULT (datetime('now')),
+    sent_at DATETIME,
+    FOREIGN KEY (rule_id) REFERENCES email_rules(id)
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS email_processed (
+    gmail_id TEXT PRIMARY KEY,
+    account TEXT,
+    action_taken TEXT,
+    processed_at DATETIME DEFAULT (datetime('now'))
+  )
+`);
+
+try { db.exec(`CREATE INDEX idx_email_rules_email ON email_rules(email)`); } catch(e) {}
+try { db.exec(`CREATE INDEX idx_email_rules_domain ON email_rules(domain)`); } catch(e) {}
+try { db.exec(`CREATE INDEX idx_email_drafts_status ON email_drafts(status)`); } catch(e) {}
+try { db.exec(`CREATE INDEX idx_email_drafts_gmail_id ON email_drafts(gmail_id)`); } catch(e) {}
+
+try { db.exec(`CREATE INDEX idx_contact_phone ON contact_rules(phone)`); } catch(e) {}
+try { db.exec(`CREATE INDEX idx_log_phone ON message_log(phone)`); } catch(e) {}
+try { db.exec(`CREATE INDEX idx_log_timestamp ON message_log(timestamp)`); } catch(e) {}
+try { db.exec(`ALTER TABLE message_log ADD COLUMN attachment_url TEXT DEFAULT ''`); } catch(e) {}
+try { db.exec(`ALTER TABLE message_log ADD COLUMN sent_by TEXT DEFAULT ''`); } catch(e) {}
+try { db.exec(`CREATE INDEX idx_pending_phone ON pending_requests(phone)`); } catch(e) {}
+try { db.exec(`CREATE INDEX idx_pending_status ON pending_requests(status)`); } catch(e) {}
+
+// ── Contact Permissions Tables ──────────────────────────────────
+db.exec(`
+  CREATE TABLE IF NOT EXISTS contact_permissions (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    phone TEXT NOT NULL,
+    permission_type TEXT NOT NULL,
+    allowed INTEGER NOT NULL DEFAULT 0,
+    granted_by TEXT DEFAULT 'system',
+    granted_at DATETIME DEFAULT (datetime('now')),
+    booking_category TEXT DEFAULT '',
+    booking_description TEXT DEFAULT '',
+    UNIQUE(phone, permission_type)
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS permission_requests (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    phone TEXT NOT NULL,
+    contact_name TEXT DEFAULT 'Unknown',
+    permission_type TEXT NOT NULL,
+    request_details TEXT DEFAULT '',
+    original_message TEXT DEFAULT '',
+    token TEXT UNIQUE NOT NULL,
+    status TEXT DEFAULT 'pending',
+    created_at DATETIME DEFAULT (datetime('now')),
+    resolved_at DATETIME
+  )
+`);
+
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_permission_requests_token ON permission_requests(token)`); } catch(e) {}
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_permission_requests_status ON permission_requests(status)`); } catch(e) {}
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_contact_permissions_phone ON contact_permissions(phone)`); } catch(e) {}
+
+// ── Contact Scopes Table (OAuth-style permission scopes) ──────────
+db.exec(`
+  CREATE TABLE IF NOT EXISTS contact_scopes (
+    phone TEXT NOT NULL,
+    scope TEXT NOT NULL,
+    granted INTEGER DEFAULT 0,
+    granted_by TEXT DEFAULT 'manual',
+    granted_at TEXT,
+    PRIMARY KEY (phone, scope)
+  )
+`);
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_contact_scopes_phone ON contact_scopes(phone)`); } catch(e) {}
+
+// ── Migrate existing contact_permissions → contact_scopes (one-time) ──
+const PERMISSION_TO_SCOPES_MAP = {
+  'scheduling': ['calendar.view', 'calendar.book'],
+  'reminders': ['reminders.create'],
+  'messaging': ['messages.send', 'messages.auto-reply'],
+  'task-creation': ['tasks.create'],
+  'info-lookup': ['info.business'],
+};
+
+try {
+  const migrated = db.prepare("SELECT value FROM settings WHERE key = 'scopes_migrated'").get();
+  if (!migrated) {
+    const existingPerms = db.prepare('SELECT * FROM contact_permissions WHERE allowed = 1').all();
+    const upsertScope = db.prepare(`INSERT INTO contact_scopes (phone, scope, granted, granted_by, granted_at) VALUES (?, ?, 1, 'migrated', datetime('now')) ON CONFLICT(phone, scope) DO NOTHING`);
+    for (const perm of existingPerms) {
+      const scopes = PERMISSION_TO_SCOPES_MAP[perm.permission_type] || [];
+      for (const scope of scopes) {
+        upsertScope.run(perm.phone, scope);
+      }
+    }
+    db.prepare("INSERT OR REPLACE INTO settings (key, value) VALUES ('scopes_migrated', '1')").run();
+    console.log(`[scopes-migration] Migrated ${existingPerms.length} permission records to scopes`);
+  }
+} catch(e) { console.error('[scopes-migration] Error:', e.message); }
+
+const stmts = {
+  getAllRules: db.prepare('SELECT * FROM contact_rules ORDER BY name'),
+  getRuleByPhone: db.prepare('SELECT * FROM contact_rules WHERE phone = ?'),
+  searchRules: db.prepare("SELECT * FROM contact_rules WHERE name LIKE ? OR phone LIKE ? ORDER BY name"),
+  filterByCategory: db.prepare('SELECT * FROM contact_rules WHERE category = ? ORDER BY name'),
+  upsertRule: db.prepare(`
+    INSERT INTO contact_rules (phone, name, category, response_mode, style, context, instructions, priority, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))
+    ON CONFLICT(phone) DO UPDATE SET
+      name=excluded.name, category=excluded.category, response_mode=excluded.response_mode,
+      style=excluded.style, context=excluded.context, instructions=excluded.instructions,
+      priority=excluded.priority, updated_at=datetime('now')
+  `),
+  deleteRule: db.prepare('DELETE FROM contact_rules WHERE phone = ?'),
+  updateContactCategory: db.prepare('UPDATE contact_rules SET category = ? WHERE phone = ?'),
+  insertLog: db.prepare(`
+    INSERT INTO message_log (phone, direction, message_preview, rules_applied, forwarded_to, source, sent_by)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `),
+  insertLogWithAttachment: db.prepare(`
+    INSERT INTO message_log (phone, direction, message_preview, rules_applied, forwarded_to, attachment_url, source, sent_by)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `),
+  getRecentLogs: db.prepare(`SELECT m.*, COALESCE(NULLIF(cr.name, ''), NULLIF(cc.name, ''), m.phone) AS contact_name FROM message_log m LEFT JOIN contact_rules cr ON cr.phone = m.phone LEFT JOIN contact_context cc ON cc.phone = m.phone ORDER BY m.timestamp DESC LIMIT ?`),
+  getLogsByPhone: db.prepare(`SELECT m.*, COALESCE(NULLIF(cr.name, ''), NULLIF(cc.name, ''), m.phone) AS contact_name FROM message_log m LEFT JOIN contact_rules cr ON cr.phone = m.phone LEFT JOIN contact_context cc ON cc.phone = m.phone WHERE m.phone = ? ORDER BY m.timestamp DESC LIMIT ?`),
+  countLogsByPhone: db.prepare('SELECT COUNT(*) as count FROM message_log WHERE phone = ?'),
+  countRules: db.prepare('SELECT COUNT(*) as c FROM contact_rules'),
+  insertOrIgnoreRule: db.prepare(`
+    INSERT OR IGNORE INTO contact_rules (phone, name, category, response_mode, style, context, instructions, priority)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `),
+
+  getContext: db.prepare('SELECT * FROM contact_context WHERE phone = ?'),
+  getAllContexts: db.prepare('SELECT * FROM contact_context ORDER BY last_interaction DESC'),
+  upsertContext: db.prepare(`
+    INSERT INTO contact_context (phone, name, relationship, last_topic, pending_items, preferences_learned, conversation_summary, last_interaction, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, datetime('now'), datetime('now'))
+    ON CONFLICT(phone) DO UPDATE SET
+      name=excluded.name, relationship=excluded.relationship, last_topic=excluded.last_topic,
+      pending_items=excluded.pending_items, preferences_learned=excluded.preferences_learned,
+      conversation_summary=excluded.conversation_summary, last_interaction=datetime('now'), updated_at=datetime('now')
+  `),
+  deleteContext: db.prepare('DELETE FROM contact_context WHERE phone = ?'),
+
+  insertPending: db.prepare(`
+    INSERT INTO pending_requests (request_id, phone, type, conversation_context, status, request_data)
+    VALUES (?, ?, ?, ?, 'waiting', ?)
+  `),
+  getPending: db.prepare('SELECT * FROM pending_requests WHERE request_id = ?'),
+  getPendingByPhone: db.prepare("SELECT * FROM pending_requests WHERE phone = ? AND status = 'waiting' ORDER BY created_at DESC"),
+  resolvePending: db.prepare(`
+    UPDATE pending_requests SET status = 'resolved', response_data = ?, resolved_at = datetime('now') WHERE request_id = ?
+  `),
+  getRecentPending: db.prepare('SELECT * FROM pending_requests ORDER BY created_at DESC LIMIT ?'),
+
+  checkEscalation: db.prepare('SELECT id FROM escalation_log WHERE phone = ? AND type = ? AND details_hash = ?'),
+  insertEscalation: db.prepare(`INSERT INTO escalation_log (phone, type, details_hash, details_text) VALUES (?, ?, ?, ?)`),
+  getEscalationsByPhone: db.prepare('SELECT * FROM escalation_log WHERE phone = ? ORDER BY created_at DESC LIMIT ?'),
+  clearEscalations: db.prepare('DELETE FROM escalation_log WHERE phone = ?'),
+
+  getActiveMonitoring: db.prepare('SELECT * FROM monitoring_sessions WHERE active = 1 ORDER BY id DESC LIMIT 1'),
+  insertMonitoringSession: db.prepare('INSERT INTO monitoring_sessions (active, reason, auto) VALUES (1, ?, 0)'),
+  insertAutoMonitoringSession: db.prepare('INSERT INTO monitoring_sessions (active, reason, auto) VALUES (1, ?, 1)'),
+  endMonitoringSession: db.prepare("UPDATE monitoring_sessions SET active = 0, ended_at = datetime('now') WHERE active = 1"),
+  endAutoMonitoringSession: db.prepare("UPDATE monitoring_sessions SET active = 0, ended_at = datetime('now') WHERE active = 1 AND auto = 1"),
+  getIntroduction: db.prepare('SELECT id FROM monitoring_introductions WHERE session_id = ? AND phone = ?'),
+  insertIntroduction: db.prepare('INSERT INTO monitoring_introductions (session_id, phone) VALUES (?, ?)'),
+
+  getLastOutboundByPhone: db.prepare(`SELECT timestamp FROM message_log WHERE phone = ? AND direction = 'outbound' ORDER BY timestamp DESC LIMIT 1`),
+  getLastSentBy: db.prepare(`SELECT sent_by FROM message_log WHERE phone = ? AND direction = 'outbound' AND sent_by != '' ORDER BY timestamp DESC LIMIT 1`),
+  markIntroduced: db.prepare('UPDATE contact_rules SET aiva_introduced = 1 WHERE phone = ?'),
+  resetIntroduced: db.prepare('UPDATE contact_rules SET aiva_introduced = 0 WHERE phone = ?'),
+
+  getSchedulingRule: db.prepare('SELECT * FROM scheduling_rules WHERE category = ?'),
+  upsertSchedulingRule: db.prepare("INSERT OR REPLACE INTO scheduling_rules (category, rule_preset, custom_instructions, structured_overrides, updated_at) VALUES (?, ?, ?, ?, datetime('now'))"),
+  getAllSchedulingRules: db.prepare('SELECT * FROM scheduling_rules'),
+
+  getGroupChat: db.prepare('SELECT * FROM group_chats WHERE chat_guid = ?'),
+  upsertGroupChat: db.prepare("INSERT OR REPLACE INTO group_chats (chat_guid, name, purpose, response_mode, personality, custom_instructions, enabled, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, datetime('now'))"),
+  getAllGroupChats: db.prepare('SELECT * FROM group_chats ORDER BY updated_at DESC'),
+  getGroupContext: db.prepare('SELECT * FROM group_chat_context WHERE chat_guid = ?'),
+  upsertGroupContext: db.prepare("INSERT OR REPLACE INTO group_chat_context (chat_guid, last_topic, conversation_summary, updated_at) VALUES (?, ?, ?, datetime('now'))"),
+
+  // Group participants
+  upsertGroupParticipant: db.prepare("INSERT INTO group_participants (chat_guid, phone, display_name) VALUES (?, ?, ?) ON CONFLICT(chat_guid, phone) DO UPDATE SET display_name = CASE WHEN excluded.display_name != '' THEN excluded.display_name ELSE display_name END, last_seen = datetime('now')"),
+  getGroupParticipants: db.prepare('SELECT * FROM group_participants WHERE chat_guid = ? ORDER BY last_seen DESC'),
+  getGroupByEscalationCode: db.prepare('SELECT * FROM group_chats WHERE escalation_code = ?'),
+
+  insertEscalationV2: db.prepare(`INSERT INTO escalations (code, phone, contact_name, message_text, expires_at, token) VALUES (?, ?, ?, ?, datetime('now', '+24 hours'), ?)`),
+  getEscalationByCode: db.prepare(`SELECT * FROM escalations WHERE code = ?`),
+  getEscalationByToken: db.prepare(`SELECT * FROM escalations WHERE token = ? AND status = 'pending' AND expires_at > datetime('now')`),
+  resolveEscalation: db.prepare(`UPDATE escalations SET status = 'responded', response_instructions = ?, ai_response = ?, responded_at = datetime('now') WHERE code = ?`),
+  getActiveEscalations: db.prepare(`SELECT * FROM escalations WHERE status = 'pending' AND expires_at > datetime('now')`),
+  expireOldEscalations: db.prepare(`UPDATE escalations SET status = 'expired' WHERE status = 'pending' AND expires_at < datetime('now')`),
+
+  // Email router statements
+  getAllEmailRules: db.prepare('SELECT * FROM email_rules ORDER BY id DESC'),
+  getEmailRuleByEmail: db.prepare('SELECT * FROM email_rules WHERE email = ?'),
+  getEmailRuleByDomain: db.prepare('SELECT * FROM email_rules WHERE domain = ?'),
+  insertEmailRule: db.prepare(`INSERT INTO email_rules (email, domain, sender_name, action, instructions, auto_respond_template, auto_respond_mode) VALUES (?, ?, ?, ?, ?, ?, ?)`),
+  updateEmailRule: db.prepare(`UPDATE email_rules SET email=?, domain=?, sender_name=?, action=?, instructions=?, auto_respond_template=?, auto_respond_mode=?, updated_at=datetime('now') WHERE id=?`),
+  deleteEmailRule: db.prepare('DELETE FROM email_rules WHERE id = ?'),
+  getEmailRuleById: db.prepare('SELECT * FROM email_rules WHERE id = ?'),
+
+  getAllEmailDrafts: db.prepare('SELECT * FROM email_drafts ORDER BY created_at DESC'),
+  getEmailDraftsByStatus: db.prepare('SELECT * FROM email_drafts WHERE status = ? ORDER BY created_at DESC LIMIT ?'),
+  getEmailDraftById: db.prepare('SELECT * FROM email_drafts WHERE id = ?'),
+  insertEmailDraft: db.prepare(`INSERT INTO email_drafts (gmail_id, account, from_email, from_name, to_email, subject, body_text, body_html, ai_draft, status, action_taken, rule_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+  updateEmailDraftStatus: db.prepare(`UPDATE email_drafts SET status=?, action_taken=?, sent_at=CASE WHEN ?='sent' THEN datetime('now') ELSE sent_at END WHERE id=?`),
+  updateEmailDraftAiDraft: db.prepare(`UPDATE email_drafts SET ai_draft=? WHERE id=?`),
+
+  getEmailProcessed: db.prepare('SELECT * FROM email_processed WHERE gmail_id = ?'),
+  insertEmailProcessed: db.prepare(`INSERT OR IGNORE INTO email_processed (gmail_id, account, action_taken) VALUES (?, ?, ?)`),
+
+  // Permission statements
+  getPermission: db.prepare('SELECT * FROM contact_permissions WHERE phone = ? AND permission_type = ?'),
+  getAllPermissions: db.prepare('SELECT * FROM contact_permissions WHERE phone = ?'),
+  getAllPermissionsAll: db.prepare('SELECT * FROM contact_permissions ORDER BY phone, permission_type'),
+  upsertPermission: db.prepare(`INSERT INTO contact_permissions (phone, permission_type, allowed, granted_by, granted_at) VALUES (?, ?, ?, ?, datetime('now')) ON CONFLICT(phone, permission_type) DO UPDATE SET allowed=excluded.allowed, granted_by=excluded.granted_by, granted_at=datetime('now')`),
+  deletePermission: db.prepare('DELETE FROM contact_permissions WHERE phone = ? AND permission_type = ?'),
+
+  // Scope statements
+  getScope: db.prepare('SELECT * FROM contact_scopes WHERE phone = ? AND scope = ?'),
+  getAllScopes: db.prepare('SELECT * FROM contact_scopes WHERE phone = ?'),
+  getAllScopesAll: db.prepare('SELECT * FROM contact_scopes ORDER BY phone, scope'),
+  upsertScope: db.prepare(`INSERT INTO contact_scopes (phone, scope, granted, granted_by, granted_at) VALUES (?, ?, ?, ?, datetime('now')) ON CONFLICT(phone, scope) DO UPDATE SET granted=excluded.granted, granted_by=excluded.granted_by, granted_at=datetime('now')`),
+  deleteScope: db.prepare('DELETE FROM contact_scopes WHERE phone = ? AND scope = ?'),
+  deleteScopesByPhone: db.prepare('DELETE FROM contact_scopes WHERE phone = ?'),
+  insertPermissionRequest: db.prepare(`INSERT INTO permission_requests (phone, contact_name, permission_type, request_details, original_message, token) VALUES (?, ?, ?, ?, ?, ?)`),
+  getPermissionRequest: db.prepare('SELECT * FROM permission_requests WHERE token = ?'),
+  resolvePermissionRequest: db.prepare(`UPDATE permission_requests SET status = ?, resolved_at = datetime('now') WHERE token = ?`),
+  getPendingPermissionRequests: db.prepare("SELECT * FROM permission_requests WHERE status = 'pending' ORDER BY created_at DESC"),
+
+  updateContactSource: db.prepare("UPDATE contact_rules SET source = ?, updated_at = datetime('now') WHERE phone = ?"),
+
+  // Rate-limiting: count recent outbound messages to a phone
+  countRecentOutbound: db.prepare("SELECT COUNT(*) as count FROM message_log WHERE phone = ? AND direction = 'outbound' AND sent_by = 'aiva' AND timestamp >= datetime('now', '-' || ? || ' hours')"),
+  // Rate-limiting: get the last inbound message timestamp for a phone
+  getLastInboundByPhone: db.prepare("SELECT timestamp FROM message_log WHERE phone = ? AND direction = 'inbound' ORDER BY timestamp DESC LIMIT 1"),
+  getLastInboundWithPreview: db.prepare("SELECT timestamp, message_preview FROM message_log WHERE phone = ? AND direction = 'inbound' ORDER BY timestamp DESC LIMIT 1"),
+  // Rate-limiting: count follow-ups sent today for a phone
+  countRecentFollowUps: db.prepare("SELECT COUNT(*) as count FROM message_log WHERE phone = ? AND direction = 'outbound' AND rules_applied LIKE '%followUp%' AND timestamp >= datetime('now', '-24 hours')"),
+
+  getSetting: db.prepare('SELECT value FROM settings WHERE key = ?'),
+  setSetting: db.prepare(`
+    INSERT INTO settings (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = excluded.value
+  `),
+  getAllSettings: db.prepare('SELECT * FROM settings'),
+};
+
+// ── Character Profiles Tables ──────────────────────────────────
+db.exec(`
+  CREATE TABLE IF NOT EXISTS characters (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    description TEXT DEFAULT '',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+  )
+`);
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS character_images (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    character_id INTEGER NOT NULL,
+    filename TEXT NOT NULL,
+    original_name TEXT,
+    file_path TEXT NOT NULL,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (character_id) REFERENCES characters(id) ON DELETE CASCADE
+  )
+`);
+
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_character_images_char ON character_images(character_id)`); } catch(e) {}
+
+// ── Follow-Up Tracker Table ──────────────────────────────
+db.exec(`
+  CREATE TABLE IF NOT EXISTS follow_up_tracker (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    phone TEXT NOT NULL,
+    channel TEXT DEFAULT 'imessage',
+    contact_name TEXT DEFAULT 'Unknown',
+    last_our_message TEXT DEFAULT '',
+    last_our_message_at DATETIME,
+    context_summary TEXT DEFAULT '',
+    follow_up_count INTEGER DEFAULT 0,
+    max_follow_ups INTEGER DEFAULT 3,
+    next_follow_up_at DATETIME,
+    status TEXT DEFAULT 'active',
+    last_follow_up_at DATETIME,
+    opted_out INTEGER DEFAULT 0,
+    created_at DATETIME DEFAULT (datetime('now')),
+    updated_at DATETIME DEFAULT (datetime('now')),
+    UNIQUE(phone)
+  )
+`);
+
+try { db.exec(`ALTER TABLE contact_context ADD COLUMN pending_action TEXT DEFAULT NULL`); } catch(e) {}
+try { db.exec(`ALTER TABLE contact_context ADD COLUMN pending_action_set_at TEXT DEFAULT NULL`); } catch(e) {}
+
+try { db.exec(`ALTER TABLE follow_up_tracker ADD COLUMN last_follow_up_topic TEXT DEFAULT ''`); } catch(e) {}
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_follow_up_status ON follow_up_tracker(status)`); } catch(e) {}
+try { db.exec(`CREATE INDEX IF NOT EXISTS idx_follow_up_next ON follow_up_tracker(next_follow_up_at)`); } catch(e) {}
+
+// Follow-up prepared statements
+stmts.getActiveFollowUps = db.prepare("SELECT * FROM follow_up_tracker WHERE status = 'active' AND next_follow_up_at <= datetime('now') AND opted_out = 0");
+stmts.getAllFollowUps = db.prepare("SELECT * FROM follow_up_tracker ORDER BY CASE status WHEN 'active' THEN 0 WHEN 'cold' THEN 1 WHEN 'paused' THEN 2 ELSE 3 END, next_follow_up_at ASC");
+stmts.getFollowUpByPhone = db.prepare("SELECT * FROM follow_up_tracker WHERE phone = ?");
+stmts.upsertFollowUp = db.prepare(`
+  INSERT INTO follow_up_tracker (phone, channel, contact_name, last_our_message, last_our_message_at, status, follow_up_count, next_follow_up_at, updated_at)
+  VALUES (?, ?, ?, ?, ?, ?, 0, datetime(?, '+2 hours'), datetime('now'))
+  ON CONFLICT(phone) DO UPDATE SET
+    channel=excluded.channel, contact_name=excluded.contact_name,
+    last_our_message=excluded.last_our_message, last_our_message_at=excluded.last_our_message_at,
+    status=excluded.status, follow_up_count=0, next_follow_up_at=datetime(excluded.last_our_message_at, '+2 hours'),
+    updated_at=datetime('now')
+`);
+stmts.updateFollowUpStatus = db.prepare("UPDATE follow_up_tracker SET status = ?, updated_at = datetime('now') WHERE phone = ?");
+stmts.incrementFollowUp = db.prepare(`
+  UPDATE follow_up_tracker SET
+    follow_up_count = follow_up_count + 1,
+    last_follow_up_at = datetime('now'),
+    next_follow_up_at = ?,
+    updated_at = datetime('now')
+  WHERE phone = ?
+`);
+stmts.deleteFollowUp = db.prepare("DELETE FROM follow_up_tracker WHERE phone = ?");
+stmts.markFollowUpCold = db.prepare("UPDATE follow_up_tracker SET status = 'cold', updated_at = datetime('now') WHERE phone = ?");
+stmts.updateFollowUpOptOut = db.prepare("UPDATE follow_up_tracker SET opted_out = ?, updated_at = datetime('now') WHERE phone = ?");
+
+// Pending action support (for scheduling flow)
+stmts.setPendingAction = db.prepare("UPDATE contact_context SET pending_action = ?, pending_action_set_at = datetime('now') WHERE phone = ?");
+stmts.clearPendingAction = db.prepare("UPDATE contact_context SET pending_action = NULL, pending_action_set_at = NULL WHERE phone = ?");
+stmts.getPendingAction = db.prepare("SELECT pending_action, pending_action_set_at FROM contact_context WHERE phone = ?");
+
+// Follow-up settings defaults
+db.exec(`INSERT OR IGNORE INTO settings (key, value) VALUES ('followUpEnabled', 'false')`);
+db.exec(`INSERT OR IGNORE INTO settings (key, value) VALUES ('followUpStartHour', '8')`);
+db.exec(`INSERT OR IGNORE INTO settings (key, value) VALUES ('followUpEndHour', '18')`);
+db.exec(`INSERT OR IGNORE INTO settings (key, value) VALUES ('followUpMaxDefault', '3')`);
+db.exec(`INSERT OR IGNORE INTO settings (key, value) VALUES ('followUpCheckIntervalMin', '30')`);
+db.exec(`INSERT OR IGNORE INTO settings (key, value) VALUES ('maxDailyAutoResponses', '3')`);
+db.exec(`INSERT OR IGNORE INTO settings (key, value) VALUES ('maxDailyFollowUps', '1')`);
+
+// ── Agent Sessions (Direct-to-Agent) ──────────────────────
+db.exec(`
+  CREATE TABLE IF NOT EXISTS agent_sessions (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    phone TEXT NOT NULL UNIQUE,
+    session_key TEXT NOT NULL,
+    skills TEXT DEFAULT '[]',
+    tool_policies TEXT DEFAULT '{}',
+    instructions TEXT DEFAULT '',
+    status TEXT DEFAULT 'active',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+  )
+`);
+
+stmts.getAgentSession = db.prepare("SELECT * FROM agent_sessions WHERE phone = ? AND status = 'active'");
+stmts.insertAgentSession = db.prepare(`INSERT INTO agent_sessions (phone, session_key, skills, tool_policies, instructions, status) VALUES (?, ?, ?, ?, ?, ?)`);
+stmts.updateAgentSession = db.prepare(`UPDATE agent_sessions SET skills = ?, tool_policies = ?, instructions = ?, status = ?, updated_at = CURRENT_TIMESTAMP WHERE phone = ?`);
+stmts.deleteAgentSession = db.prepare("UPDATE agent_sessions SET status = 'disabled', updated_at = CURRENT_TIMESTAMP WHERE phone = ?");
+stmts.listAgentSessions = db.prepare("SELECT * FROM agent_sessions ORDER BY created_at DESC");
+
+module.exports = { db, stmts };

package/router-utils.js

@@ -0,0 +1,28 @@
+// ── Shared Router Utilities ──────────────────────────────
+// Shared between router.js and follow-up-handler.js
+
+const { stmts } = require('./router-db');
+
+const REINTRO_PHRASES = [
+  "Hey, Aiva here — ",
+  "Hey, it's Aiva — ",
+  "Hey, Aiva here. ",
+  "It's Aiva — ",
+];
+
+function needsReintro(phone) {
+  try {
+    const row = stmts.getLastSentBy.get(phone);
+    return row && row.sent_by === 'owner';
+  } catch (e) {
+    return false;
+  }
+}
+
+function addReintroIfNeeded(phone, message) {
+  if (!needsReintro(phone)) return message;
+  const phrase = REINTRO_PHRASES[Math.floor(Math.random() * REINTRO_PHRASES.length)];
+  return phrase + message;
+}
+
+module.exports = { REINTRO_PHRASES, needsReintro, addReintroIfNeeded };