👥

CONTACTS

Google People sync → local SQLite → fuzzy WhatsApp answers

Neo asks in natural language; Zion classifies a contact lookup, searches contacts.db (synced from Google), fuzzy-matches names, formats phone/email/org, and replies on WhatsApp. Send/update paths are Neo-only with audit logging.

A Real Conversation

One question — structured answer from the synced address book

@zion do you know Sandeep? 3:45 PM [Zion] 📋 Found 1 contact: ━━━━━━━━━━━━━━━━━━━━━━ 👤 Sandeep Patel 📱 +91 98765 43210 📧 sandeep@email.com 🏢 TechCorp, Mumbai Source: Google Contacts 3:45 PM ✓✓ @zion find all TechCorp contacts 3:46 PM [Zion] Found 12 contacts... (showing first 5) 3:46 PM ✓✓ 🔍 click to read full brief NEO 📱 read-only lookup ZION contact query detect intent → search path contacts.db SQLite on VM synced from Google People names, phones, emails, org contacts_search.py fuzzy name match phone / email lookup rank + pick best row Format + reply [Zion] 📋 Found: … WhatsApp-safe lines WhatsApp DM contacts_sync.py Google People API v1 cron ~ every 5 min keeps DB fresh Key files: contacts_sync.py · contacts_search.py

Capability Map

Contacts construct — four pillars around search

👥 CONTACTS SYNC Google People API v1 cron every 5 minutes contacts.db (SQLite) incremental upserts SEARCH fuzzy matching name / phone / email contacts_search.py ranked single best hit SEND @zion send Sandeep "…" owner only (Neo) audit log on outbound template + safety checks SECURITY Neo-only send/update session users: read no mass export least-privilege bridge

Tech Stack

RuntimePython 3 inside zion.service handlers
Synccontacts_sync.py — Google People API v1, periodic cron
Searchcontacts_search.py — fuzzy match + formatting
Storagecontacts.db — SQLite mirror of Google contacts
DeliveryWhatsApp Bridge /api/send — [Zion] replies
AuthzNeo-only mutations; read for approved session chats
✕
👥 CONTACTS
@zion do you know Sandeep?
3:45 PM
[Zion] 📋 Found 1 contact:
━━━━━━━━━━━━━━━━━━━━━━
👤 Sandeep Patel
📱 +91 98765 43210
📧 sandeep@email.com
🏢 TechCorp, Mumbai
Source: Google Contacts
3:45 PM ✓✓
@zion find all TechCorp contacts
3:46 PM
[Zion] Found 12 contacts...
(showing first 5)
3:46 PM ✓✓