ms-outlook-teams-assistant

# MS Outlook + Teams Assistant (Desktop-first)

## What this skill does

- **Inbox nagging (Outlook Desktop)**: find messages from the last 7 days that likely need a reply, then send reminders until dismissed.
- **Email reply drafting**: produce concise drafts that match the user’s tone rules (conversational, spartan, polite; simple English; short; reduce redundancy; avoid em dashes).
- **Teams tracking (optional)**: if Microsoft Graph is configured and permitted by tenant policy, track recent Teams chat messages that likely need a reply and nag similarly.

## Safety defaults

- Do **not** auto-send emails or Teams messages.
- Create **drafts** in Outlook, or paste drafts into Telegram for approval.
- For reminders: send to **Telegram** by default; only send to Teams if explicitly enabled.

## Setup (one time)

### A) Outlook Desktop automation (recommended)

1. Ensure Outlook Desktop is installed and signed in.
2. Install the Python dependency (ask before doing this on the machine):
   - `pip install pywin32`
3. Create a config file:
   - Copy `references/config.example.json` → `references/config.json` and fill it.
   - IMPORTANT: Do not commit `references/config.json` if it contains personal IDs.

### B) Teams via Graph (optional)

Only if you can create an Entra ID app registration and grant permissions.

- Copy `references/config.example.json` → `references/config.json` and fill `teams.tenantId`, `teams.clientId`, and `teams.scopes`.
- Then run `scripts/teams_scan.py` once to complete Device Code sign-in.

See `references/teams-graph-setup.md`.

## Core workflows

### 1) Scan and remind (Outlook)

Use `scripts/scan_outlook.py`.

### 1b) Scan Teams (Graph)

Use `scripts/teams_scan.py`.

Parameters:
- `--days 7` (default)

First run will print a **device code** sign-in message (follow it once).

Parameters:
- `--days 7` (default)
- `--mode report|telegram` (default: report)
- `--max-items 200`

Heuristics (editable in config):
- Within last N days
- Not from obvious broadcast sources
- Prefer threads where user is **To:** (not only CC) OR subject/body contains direct asks
- Prefer messages not replied by user (best-effort)

Output:
- A list of actionable items with: subject, sender, received time, why it was flagged.

Then:
- If `--mode telegram`, send a single concise reminder message with bullet items.

### 2) Dismiss / snooze an item

This skill uses a local state file to avoid nag loops.

- Dismiss: add the message’s `internetMessageId` (or subject+timestamp fallback) to the dismissed list.
- Snooze: store a `snoozeUntil` timestamp.

Use `scripts/state.py` helpers (or edit JSON directly if needed).

### 3) Draft an email reply (Outlook)

Use `scripts/draft_reply.py`.

### 4) Generate reminders (no send)

Use `scripts/scan_all.py` to update cached scan results, then `scripts/remind.py` to generate a Telegram-ready reminder message (it does not send).
It applies:
- 1:1 Teams → remind when `needsReply=true`
- Group Teams → remind when `mentionedMe=true` AND `needsReply=true`
- Outlook → remind for flagged items

The agent should send the output to Telegram if non-empty.

Inputs:
- Either a message `EntryID` (preferred) or search by subject + recent window.

Behavior:
- Extract the thread (best-effort) + key metadata.
- Generate 2 drafts:
  - **Short** (2–5 sentences)
  - **Normal** (5–10 sentences)
- Apply tone rules from `references/writing-style.md`.

Outputs:
- Print drafts to stdout.
- Optionally create an Outlook **draft reply** (no sending) if `--create-draft` is set.

## When you need more context from the user

Ask only what you cannot infer:
- Which email to reply to (subject / sender / when)
- The user’s intent (agree/decline/ask for info/confirm timeline)
- Any constraints (deadlines, attachments, names)

Keep questions minimal (max 3 at a time).