Turn a Mailchimp segment into a HubSpot list

**Objective:** Put every member of the Mailchimp segment or tag named like `{segment-name}` who is already a HubSpot contact into the manual HubSpot contact list `{list-name}`, creating the list if it does not exist, after the user confirms.

**Step 1: Resolve the Mailchimp segment or tag**

Call `mailchimp-get-segment` with `name.contains` set to `{segment-name}`. Exactly one segment or tag must match. If none or several match (including the same name in different audiences), list them with name, type, member-count and list-id, and stop. Keep its `segment-id` and `list-id`.

**Step 2: Members in Mailchimp**

Call `mailchimp-get-segment-member` with `segment-id` and `list-id` set to those values and `max-records` 500. Keep `email`, `full-name` and `status`.

**Step 3: Resolve the HubSpot list**

Call `hubspot-get-lists` with `name` set to `{list-name}` and `object-type` set to 0-1. If several lists come back, list them and stop. If one comes back, its `processing-type` must be MANUAL; if it is not, say HubSpot manages that list's members and stop. Keep its `list-id`, then call `hubspot-get-contact-list-membership` with `list-id` set to it and `max-records` 1000, and note the contact-id of every current member. If no list comes back, it will be created in the write step.

**Step 4: Match each person in HubSpot**

For each distinct email address, call `hubspot-get-contacts` with `email` set to it and keep `record-id`, first and last name and `lifecycle-stage`. Sort people into: to add (a HubSpot contact not yet on the list), already on the list, not in HubSpot. If one email matches more than one contact, list them under "ambiguous" and do not add any of them. This prompt does not create contacts.

**Step 5: Confirm**

Show the HubSpot list (its name, id and size, or "will be created as a manual contact list"), then the groups: to add (email, name, Mailchimp status), already on the list (count), not in HubSpot (list), ambiguous (list). Ask the user to confirm the "to add" group, or to name people to leave out. Do nothing more until they confirm.

**Step 6: Write**

Only after confirmation:

1. If the list does not exist, call `hubspot-add-list` once with `name` set to `{list-name}`, `object-type` set to 0-1 and `processing-type` set to MANUAL. Keep the returned `id` as the list-id.
2. Call `hubspot-add-list-members` with `list-id` and `record-ids` set to the confirmed contacts' record-ids, comma-separated, in batches of at most 100.

**Step 7: Verify and report**

Call `hubspot-get-lists` with `list-id` and report its size (HubSpot can take a minute to update it). Then the totals: added, already on the list, not in HubSpot, ambiguous, failed (with the error).

**Rules & Guidelines:**

* `mailchimp-get-segment` and `mailchimp-get-segment-member` are on the Mailchimp server; `hubspot-get-lists`, `hubspot-get-contact-list-membership`, `hubspot-get-contacts`, `hubspot-add-list` and `hubspot-add-list-members` are on the hubspot server.
* `hubspot-add-list` (at most once) and `hubspot-add-list-members` (once per batch) are the only write tools this prompt may call, and only after confirmation. Do NOT call `hubspot-remove-list-members` or `hubspot-add-contact`, and call no other hubspot-add, hubspot-update, hubspot-rename, hubspot-remove, hubspot-subscribe, hubspot-unsubscribe or hubspot-import tool. This prompt only adds members; it never removes anyone already on the list.
* Mailchimp is read-only here. Do NOT call `mailchimp-add-list-member`, `mailchimp-update-list-member`, `mailchimp-add-customer`, `mailchimp-update-customer`, `mailchimp-add-segment-member`, `mailchimp-start-automation`, `mailchimp-pause-automation`, `mailchimp-replicate-campaign`, `mailchimp-update-product` or `mailchimp-update-order`.
* Membership of a HubSpot list does not change anyone's email consent. Do not treat it as a subscription, and do not subscribe anyone.
* Match on email address only, compared case-insensitively with surrounding spaces trimmed.

**Validation:**

* If Mailchimp returns nobody, say so and stop before creating the list.
* If nobody is left to add, report the counts and stop without asking for confirmation or creating the list.
* If one batch fails, report it with the error and continue with the next.