{"id":"email-mailbox-parse","version":"1.0.0","description":"Parse one RFC 5322 mailbox into parts and canonical text, without a delivery claim.","supported_operations":["parse rfc 5322 mailbox","split mailbox display name into words","extract mailbox local part and domain","decode quoted mailbox local part","count comments in an email mailbox","read addr-spec or name-addr parts","פירוק תיבת דואר למבנה"],"unsupported_operations":["look up DNS or claim the mailbox can receive mail","decode RFC 2047 encoded-words","parse a mailbox list or a group","convert a domain to punycode"],"semantics":["One mailbox only: name-addr or addr-spec from RFC 5322 section 3.4.1. Display-name is a phrase of one or more words, and each word is one atom or one quoted-string (sections 3.2.3 and 3.2.4), with CFWS between words. A leading quote starts only that quoted-string; later words are parsed separately.","Dot-atom, quoted-string, comments, and domain-literals are accepted. Obsolete phrase dots, obsolete routes, lists, and groups are rejected. FWS inside a quoted-string keeps its space and tab characters and drops CRLF. Canonical text quotes a word or local-part only when it is not an atom or dot-atom, and it omits comments.","display_words keeps the source word form. display_name and canonical use that canonical quoting. Case is preserved. utf8 defaults to false; true allows RFC 6532 section 3.2 UTF-8 scalars in atoms, quoted strings, comments, and domain literals, with no Unicode normalization and no IDNA.","No DNS lookup, no mailbox-existence check, and no deliverability claim. Limits are enforced before or as soon as a component exceeds its cap."],"limits":{"max_mailbox_bytes":256,"max_local_part_chars":64,"max_domain_chars":190,"max_display_words":8,"max_word_chars":64,"max_comment_depth":4,"max_comments":8,"max_output_bytes":2048},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["mailbox"],"properties":{"mailbox":{"type":"string","minLength":1,"maxLength":256},"utf8":{"type":"boolean"}}},"output_schema":{"type":"object","additionalProperties":false,"required":["form","local_part","local_form","domain","domain_form","display_name","display_words","comment_count","canonical","utf8_mode"],"properties":{"form":{"type":"string","enum":["addr-spec","name-addr"]},"local_part":{"type":"string","minLength":0,"maxLength":64},"local_form":{"type":"string","enum":["dot-atom","quoted-string"]},"domain":{"type":"string","minLength":0,"maxLength":190},"domain_form":{"type":"string","enum":["dot-atom","domain-literal"]},"display_name":{"type":["string","null"],"maxLength":1200},"display_words":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["form","text"],"properties":{"form":{"type":"string","enum":["atom","quoted-string"]},"text":{"type":"string","minLength":0,"maxLength":64}}}},"comment_count":{"type":"integer","minimum":0,"maximum":8},"canonical":{"type":"string","minLength":3,"maxLength":1600},"utf8_mode":{"type":"boolean"}}},"examples":[{"input":{"mailbox":"John Doe <jdoe@machine.example>"},"output":{"form":"name-addr","local_part":"jdoe","local_form":"dot-atom","domain":"machine.example","domain_form":"dot-atom","display_name":"John Doe","display_words":[{"form":"atom","text":"John"},{"form":"atom","text":"Doe"}],"comment_count":0,"canonical":"John Doe <jdoe@machine.example>","utf8_mode":false}},{"input":{"mailbox":"\"Joe Q.\" Public <x@y>"},"output":{"form":"name-addr","local_part":"x","local_form":"dot-atom","domain":"y","domain_form":"dot-atom","display_name":"\"Joe Q.\" Public","display_words":[{"form":"quoted-string","text":"Joe Q."},{"form":"atom","text":"Public"}],"comment_count":0,"canonical":"\"Joe Q.\" Public <x@y>","utf8_mode":false}},{"input":{"mailbox":"jdoe@example.org"},"output":{"form":"addr-spec","local_part":"jdoe","local_form":"dot-atom","domain":"example.org","domain_form":"dot-atom","display_name":null,"display_words":[],"comment_count":0,"canonical":"jdoe@example.org","utf8_mode":false}}],"execute_url":"/v1/tools/email-mailbox-parse/versions/1.0.0/execute"}