History

Interaction log that records email actions for learning. Helps the AI identify patterns and improve over time.

Purpose

History tracks what happened with emails so the AI can learn patterns and make better decisions. It records actions taken, templates used, and whether they worked.

Auto-Populated

History is primarily written by the AI during blitz sessions. You don't need to maintain it manually.

What Gets Logged

Email details (UID, sender, subject)
Action taken (replied, archived, delegated, etc.)
Template used (if any)
Response time
Whether it was helpful (feedback)

Entry Structure

{
  "email_uid": "37801",
  "account_id": "work-uuid",
  "from": "[email protected]",
  "subject": "Question about pricing",
  "action_taken": "replied",
  "template_used": "pricing-inquiry",
  "response_time_mins": 15,
  "was_helpful": true,
  "notes": "Customer was satisfied with response",
  "timestamp": "2026-01-08T14:30:00Z"
}

Field Reference

Field	Description
`email_uid`	Email identifier
`account_id`	Which account this was from
`from`	Sender email address
`subject`	Email subject line
`action_taken`	What was done (see Action Types)
`template_used`	Template ID if one was used
`response_time_mins`	Time to respond in minutes
`was_helpful`	User feedback: null, true, or false
`notes`	Additional context
`timestamp`	When action was taken (ISO format)

Action Types

Action	Description
`replied`	Sent a reply
`archived`	Moved to archive
`moved:folder`	Moved to specific folder
`delegated:email`	Handed off to someone
`ignored`	No action taken
`forwarded`	Forwarded elsewhere

How AI Uses History

Pattern discovery — Identify recurring email types and successful responses
Template effectiveness — Track which templates work well
Response time tracking — Understand urgency patterns
Learning from feedback — Improve based on was_helpful flags

What to Log

The AI should log significant actions, not every archive:

Replies to customers or important contacts
Actions where a template was used
Delegations and handoffs
Situations that could inform future behavior

Privacy Note

History contains email metadata. It's stored locally and included in sync exports. Be mindful of what gets logged.

File Location

~/.config/pontius/knowledge/history/history.json