The built-in toolkit

Every other connection attaches something you run. This one is Caterfli itself, so there is no host, no key, and nothing that can fall out of sync. Add it and the tools are there.

What it gives an agent

• •Today's date and time. A model has no clock. Without this it guesses, and guesses wrong.
• •Date arithmetic — move a date forward or back by days, weeks, months or years.
• •The gap between two dates — how many days, and which way round.
• •A calculator. Real arithmetic instead of the model's own, which is wrong in the worst possible way: confidently, and looking exactly like an answer.
• •A reference code generator — a random reference for a booking or ticket number. It is random, not checked against anything, so confirm it is free if the column is unique.
• •Scheduling — "every Sunday send me the sales report", arranged and then carried out on its own. This is what puts anything under Scheduled.
• •Send an email.

The dates, the arithmetic and the reference are pure functions. They read nothing and change nothing, which is why they are classed as reads and never queue for approval. Scheduling does leave something behind, so it is classed as a change and shows up in the change log — but it is your own schedule, not anybody's data, so it does not wait for approval either.

Set the timezone

Timezone takes an IANA name such as Asia/Dhaka, and it decides what "today" means for every date tool here. It defaults to UTC, which is rarely what anyone wants — set it when you create the connection.

It does not govern scheduling. "Every Sunday at nine" is stated in the workspace's timezone, the one under Settings, because a schedule belongs to the workspace rather than to whichever connection happened to arrange it. Set both, and set them the same unless you meant otherwise.

Email is guarded four ways

Sending is the only thing on this platform that cannot be undone. A wrong row in a database can be corrected; a sent message cannot be recalled. So:

No agent gets it switched on. The rest of the toolkit arrives working on every agent; this one arrives linked and off, so an agent offers to email only once somebody has decided it should. Turn it on from the agent's own page.

Recipients are checked against a domain allow-list, and the list starts empty. Empty permits nothing rather than everything, so a connection you have not finished configuring cannot email the world. Domains match exactly — acme.com does not cover mail.acme.com. List both if you need both.

The recipient count is capped, counting everyone copied. Five by default, so a mistake reaches a handful of people rather than a mailing list.

Sending needs human approval by default, because it is classed as an action and marked high risk. You can relax that on the tools page. The platform will not relax it for you.

Reply-to is optional — set it if replies should go somewhere other than the sending address.