---
name: log-work-expense
description: Log work expense receipts into MongoDB. Use when the user sends a receipt image (photo of a receipt) along with context about the expense, or says things like "log this expense", "record this receipt", "add this to my work expenses", "expense entry", or provides receipt details for work reimbursement tracking.
---

# Log Work Expense

Log receipt images and expense details into the `wip.work_expenses` collection in MongoDB.

## Trigger Phrases

- "log this expense"
- "record this receipt"
- "add this to my work expenses"
- "expense entry"

## Steps

1. **Upload the receipt image to S2** — If the user provided an image, upload it to S2 and get the public URL. If they only provided a file or no image, skip this step.

2. **Insert into MongoDB** — Insert a document into `wip.work_expenses` with this structure:

```json
{
  "file": "https://s2.connorrhodes.com/agent/{sha256}.{ext}",
  "date": "YYYY-MM-DD",
  "merchant": "Name of the merchant",
  "description": "Context the user provided about the expense",
  "status": "todo"
}
```

- **file**: The S2 URL of the uploaded receipt image. Omit if no image was provided.
- **date**: Always use today's date (the date you receive the message), formatted as YYYY-MM-DD.
- **merchant**: Ask the user if not stated.
- **description**: What the user told you about the expense (e.g. "travel meal during LTISD onsite"). If they didn't provide context, ask.
- **status**: Always set to `"todo"` when inserting.

3. **Confirm** — Reply with a brief confirmation showing what was logged (date, merchant, and file link if applicable).

## Notes

- Use `uv run --with pymongo` for MongoDB scripts.
- Use the S2 upload endpoint from TOOLS.md for file uploads.
