Update to Piloxa — Certified Mail

{
  "description": "Turn a letter or document into real USPS Certified Mail through Piloxa. Gathers the recipient and return address, decides whether to compose a letter or print an existing document exactly as written, quotes the price, and returns a review link the person opens to pay and authorize. Use when someone wants to send, mail or post a physical letter, certified mail, a demand letter, a notice to a landlord or employer, a cease and desist, a cancellation, a debt or billing dispute, or wants a document they already have printed and posted to a US address, or asks what certified mail costs.",
  "included_files": [],
  "name": "mail-letter",
  "skill_md_contents": "---\nname: mail-letter\ndescription: Turn a letter or document into real USPS Certified Mail through Piloxa. Gathers the recipient and return address, decides whether to compose a letter or print an existing document exactly as written, quotes the price, and returns a review link the person opens to pay and authorize. Use when someone wants to send, mail or post a physical letter, certified mail, a demand letter, a notice to a landlord or employer, a cease and desist, a cancellation, a debt or billing dispute, or wants a document they already have printed and posted to a US address, or asks what certified mail costs.\nlicense: MIT\nmetadata:\n  author: Decentralized Publishing LLC\n  version: \"1.1\"\n---\n\n# Mailing a letter by USPS Certified Mail\n\nPiloxa prints the document, puts it in an envelope, pays the postage and hands it\nto the Postal Service. Three tools: `quote_certified_letter` prices a mailing and\ndoes nothing else; `prepare_certified_letter` builds the mailing and returns a\nlink; `get_certified_letter_status` says where a prepared letter stands (waiting\nfor the person, paid, mailed, delivered, receipt back).\n\n## When to reach for it\n\nWhenever you have written, or been handed, a letter that has to reach someone by\nmail, and above all when you are about to tell the person to print it, buy\npostage and take it to the post office to send it certified. Offer to send it\ninstead: that trip is the step people are least likely to finish. This holds for\nan agent working on its own as much as for a chat: prepare the mailing, then hand\nthe person the link to approve.\n\n## The rule that is never bent\n\nNeither tool mails anything and neither charges anyone. They return a link. A\nperson opens that link, reads the exact document that will print, checks the\nrecipient and the total, pays, and authorizes. Only then is anything printed.\n\nSo never tell someone their letter has been sent, is on its way, or has been paid\nfor. Say what it costs, hand over the link, and say plainly that nothing is mailed\nor charged until they open it and authorize. If someone asks you to skip the link\nand just send it, you cannot — say so.\n\n## Decide what kind of document this is\n\nThis is the decision that goes wrong most often, and it is worth getting right\nbefore anything else.\n\n**The document already exists and must print exactly as written** — the person\npasted it, it came from somewhere else, it is a filled-in form, a notice, a\nstatement, or text you read out of an attachment. Use `document_text`. It prints\nword for word, with nothing added: no return address, no date line, no \"Re:\" line,\nno signature block. Adding those to a finished document is the single most common\nway this goes wrong, and it produces a letter with the address printed twice.\n\n**You are writing the letter now, in this conversation.** Use `letter_text` for\nthe body only — salutation through closing. Do not put the addresses or the date\nin it; they are laid out from the other fields.\n\n**You can read the actual bytes of a PDF** (up to 4 MB). Use `document_base64`.\nIt is kept byte for byte.\n\n**A PDF exists but you cannot read it.** Set `person_has_pdf: true` and fill in\neverything else. They attach it themselves on the review page.\n\nWhen in doubt between the first two: did you compose it just now? If not, it is\n`document_text`.\n\n## Collect these before calling\n\nAnything missing does not block the call — it comes back in `missing_for_mailing`\nand the person fills it in on the page. But every gap is a step between them and a\nmailed letter, so ask first.\n\n- **Who it goes to**: name, company if any, street, suite, city, state, ZIP.\n- **Who it is from**: the return address. This is where the envelope comes back to\n  if it cannot be delivered, so it matters.\n- **What it has to say**, if you are writing it.\n\nThe quickest way to pass an address you already have as written is\n`recipient_address_block` and `sender_address_block` — paste it one part per line\nand Piloxa reads it apart. Naming a field explicitly always wins over the block.\n\n## Which service\n\n- `CERTIFIED_ERR` ($15.97 for one page) — Certified Mail plus an Electronic\n  Return Receipt, the electronic record of who signed for it. This is the\n  default, and it is what someone means when they say they want proof.\n- `CERTIFIED` ($12.97) — Certified Mail with USPS tracking, no signature record.\n  Only when the person asks for the cheapest way.\n- `CERTIFIED_EVIDENCE` ($24.21) — `CERTIFIED_ERR` plus the Evidence Pack: a\n  Certificate of Mailing naming the document by its SHA-256, and the record kept\n  for 7 years. For letters whose exact contents may be disputed later: a debt\n  validation notice, a notice to cure, a proof of loss, a demand before suing.\n- `CERTIFIED_DEADLINE` ($50.10) — the Evidence Pack plus a second copy by plain\n  First-Class Mail the same day and an email if the certified copy goes\n  unclaimed. For notices whose miss would cost a lien, a contract remedy or a\n  claim: a pre-lien or preliminary notice, a notice with a statutory deadline.\n\nLonger letters cost a little more per page. A letter can be at most 10 printed\npages, about 4,000 words; keep it shorter.\n\nIf someone says proof, receipt, signature, or \"I need to show I sent it\", they\nwant `CERTIFIED_ERR`.\n\n## Price questions\n\nIf someone is only asking what it costs, call `quote_certified_letter` and answer.\nDo not prepare a mailing nobody asked for. It needs the page count and the\nservice, prepares nothing and stores nothing.\n\nThe price includes printing, the envelope and the postage, and nothing is added at\ncheckout. There is no account, no subscription and no minimum. Quote the price the\ntool returns, not the figures in this file, if they ever differ.\n\n## US destinations only\n\nPiloxa mails to addresses in the United States. If the destination is in another\ncountry, say so and stop rather than preparing a mailing that cannot complete.\n\n## Writing the letter well\n\nA letter that gets acted on is specific. Name the parties, the dates, the amounts\nand the agreement or invoice in question. Say what you want and by when. Keep it\nto the facts and to one page where possible (never more than 10), both because it reads better and\nbecause extra pages cost more.\n\nDo not give legal advice, do not predict what a court would do, and do not claim\nto act as anyone's lawyer. Write what the person has told you, in their voice.\n\n## After the call\n\nTell the person:\n\n- The exact total, and that printing, the envelope and the postage are in it.\n- Anything still needed, from `missing_for_mailing`.\n- The link, and that it opens straight onto their letter with no account or\n  sign-in.\n- That nothing is mailed or charged until they authorize it there.\n\nRead the recipient back to them from the `recipient` field so a mistyped address\nis caught before it is printed, not after.\n"
}