Teaching
mximp is taught, never trained. The unit of teaching is a proposal: a schema for a bucket, plus the values one message is expected to yield. The moment it is made, the schema is run against the message; what the run does not reproduce is listed as unreproducible. Nothing the author read is ever stored as a value; only what the deterministic run produced is.
The author is your agent, using the emailimport skill. A hosted author on Cloudflare Workers AI, opt-in per tenant, is designed and not yet built; it makes the same object.
The loop
get_messageon an unrouted message, or one in a bucket without a schema. It carries afingerprintof its layout.create_bucketwith a rule if none matches.propose_schema {message_id, bucket, schema, expected}. The result hasdry_run.checksper expected field,unreproducible, andreader_evidence(where each value was seen: body or which attachment). A task is opened on the message so it stays retained.- Fix and propose again until every expected value reproduces, or accept that a field will
requires_human. approve_proposal: the bucket takes the schema (unreproducible fields markedrequires_human), the message becomes a test case with the reproduced values expected, and it is reprocessed under the new schema. The bucket's existing suite gates the change asupdate_bucketdoes;forceapplies over failures.reject_proposalrecords a reason and leaves the bucket alone.
list_proposals and get_proposal show pending, approved and rejected proposals with their dry runs and decisions.
A corpus at once
import_messages takes an mbox, a zip of .eml files (zip_base64, or a raw application/mbox / application/zip body with ?provenance=), or a list of raw messages, up to 200 and 20 MB a call. Each runs through the pipeline against the buckets you have, but nothing is delivered and no task is opened: they are candidates, deleted after candidate_days (default 7) unless a case pins them or a proposal's task holds them. The answer says how the corpus fell by bucket and by layout (fingerprint), with an example message per layout: propose_schema against each example, approve, and the layout is taught and pinned in one pass.
Layouts, and one that changes
get_bucket lists the bucket's layouts: each fingerprint pinned by a live case or approved in a proposal, with counts. When a message on a known layout is held for an extraction reason (a required field missing, validation failing, no fields at all), its task says layout: known and names the last approved proposal: the sender changed the template. A held message on a layout the bucket has not been taught says layout: new. Either way the fix is the same: propose_schema against that message; approving adds it beside the old cases, so both layouts stay covered.
Fingerprints
Each message's fingerprint is structural: the DKIM-aligned sender domain, the MIME shape, the pattern of attachment names, the ordered set of labels, a histogram of line lengths. Two messages from one sender on one template share it. It is computed as the message is processed and carried on proposals and captures; nothing in it is text the message said, and comparing two is equality, not a score. A message on a known fingerprint that stops fitting is a layout change: propose against it, and the new message joins the suite beside the old.
This page as Markdown.