---
name: track-and-proof
description: Track mailed letters and retrieve delivery proof through PostBridge. Use when the user asks for the status, tracking, delivery confirmation, or proof of delivery of a letter sent via PostBridge.
license: MIT
metadata:
  author: postbridge
  version: "0.1"
---

# Track letters and retrieve proof

## Workflow

1. **Locate the letter.** If the user gives a letter id or tracking number, use
   it directly. Otherwise call `list_letters` and match by recipient, date, or
   content description.
2. **Track.** Call `track_letter` with the letter id. Report the current
   lifecycle state, carrier events with timestamps, and the expected delivery
   date when present.
3. **Proof.** When delivery is complete (or the user asks for evidence), call
   `get_proof`. Present the proof artifact (delivery confirmation / receipt)
   with its captured date. Distinguish clearly between "mailed", "in transit",
   "delivered", and "proof available".
4. **Retries.** Tracking data arrives on carrier schedules. If a recent letter
   shows no events yet, say so and offer to check again later — do not claim
   delivery without a carrier event.

## Rules

- Never fabricate tracking states or proof. Report only what the tools return.
- Delivery proof is evidence the carrier recorded; quote the recorded date and
  event verbatim rather than paraphrasing into a guarantee.