email syncyng

2026-02-26 01:39:38 +00:00
parent 5d4f0114cd
commit 42abb97d7b
22 changed files with 1422 additions and 348 deletions
@@ -0,0 +1,101 @@
+---
+version: 3
+name: email_db
+label: Email Database
+description: Query, search, aggregate, and manage the user's email database. Use this tool to answer questions about emails, find messages by sender/domain/date/content, get statistics, and delete emails. The database is a local SQLite copy of the user's synced Gmail inbox.
+language: typescript
+inputs:
+  action:
+    type: string
+    description: "Action to perform: query, search, stats, count, domains, senders, attachments, attachment-types, delete"
+  sql:
+    type: string
+    description: "Raw SQL query for the 'query' action. Only SELECT statements are allowed unless action is 'delete'."
+    optional: true
+  search:
+    type: string
+    description: "Search term for the 'search' action. Searches subject, from, and snippet fields."
+    optional: true
+  domain:
+    type: string
+    description: "Domain to filter by (e.g. 'newsletter.example.com') for search, count, or delete actions."
+    optional: true
+  sender:
+    type: string
+    description: "Sender email address to filter by for search, count, or delete actions."
+    optional: true
+  before:
+    type: string
+    description: "ISO date string — only include emails before this date."
+    optional: true
+  after:
+    type: string
+    description: "ISO date string — only include emails after this date."
+    optional: true
+  content_type:
+    type: string
+    description: "Attachment content type filter. Full MIME type (e.g. 'image/jpeg') or just the type prefix (e.g. 'image' matches all image types). Used with 'attachments' action."
+    optional: true
+  limit:
+    type: number
+    description: "Maximum number of results to return (default 20, max 100)."
+    optional: true
+---
+
+# Email Database Tool
+
+Query and manage the user's local email database (SQLite).
+
+## Available Actions
+
+- **query**: Run a raw SELECT query against the database. Use `sql` parameter.
+- **search**: Full-text search across subject, from, and snippet. Use `search` parameter. Combine with `domain`, `sender`, `before`, `after` for filtering.
+- **stats**: Get email statistics — total count, top domains, top senders, date range.
+- **count**: Count emails matching filters (`domain`, `sender`, `before`, `after`).
+- **domains**: List all sender domains with email counts, sorted by frequency.
+- **senders**: List all senders with email counts, sorted by frequency.
+- **attachments**: Search attachments by type, filename, sender, etc. Use `content_type` for type filtering (e.g. `image` for all images, `image/jpeg` for specific type). Combine with `domain`, `sender`, `before`, `after`, `search`.
+- **attachment-types**: List all attachment content types with counts.
+- **delete**: Delete emails matching filters. Requires at least one of: `domain`, `sender`, `before`, `after`, or `sql` (with DELETE statement).
+
+## Database Schema
+
+```sql
+emails (
+  id TEXT PRIMARY KEY,
+  integration TEXT,      -- source: 'gmail', 'outlook', etc.
+  email_account TEXT,    -- which account: 'user@gmail.com'
+  from_name TEXT,
+  from_address TEXT,
+  from_domain TEXT,
+  to_address TEXT,
+  cc TEXT,
+  subject TEXT,
+  date TEXT,             -- ISO 8601
+  snippet TEXT,
+  html TEXT,
+  text_body TEXT,
+  attachment_count INTEGER,
+  read INTEGER,
+  deleted INTEGER
+)
+
+attachments (
+  email_id TEXT,
+  idx INTEGER,
+  filename TEXT,
+  size INTEGER,
+  content_type TEXT
+)
+```
+
+## Examples
+
+- Search for invoices: `action: "search", search: "invoice"`
+- Count emails from a domain: `action: "count", domain: "newsletter.com"`
+- Delete all emails from a domain: `action: "delete", domain: "spam.com"`
+- Top 10 domains: `action: "domains", limit: 10`
+- List attachment types: `action: "attachment-types"`
+- Find image attachments: `action: "attachments", content_type: "image"`
+- Find PDFs from a sender: `action: "attachments", content_type: "application/pdf", sender: "boss@company.com"`
+- Custom query: `action: "query", sql: "SELECT from_domain, COUNT(*) as n FROM emails GROUP BY from_domain HAVING n > 50 ORDER BY n DESC"`