The team and money

2 entries

m.notify

Tell one member of the owner's team one thing.

Signature

m.notify(member, text, *, key='notice')

Example · Inside a job

answer = m.notify(m.setting("who_to_tell", default=""), "Three quotes wait for a reply.", key="quotes_waiting")

member is a user id on the Ownbox, never an address: a page the machine draws is handed the person viewing it, with their id. The notice goes on their phone and by email in the next notice slot (morning or evening), once per key per slot, so a machine that asks twenty times in a morning tells them once. Put what must be seen every morning on the Morning Review instead. Never raises.

Needs in machine.yaml: Nothing
Returns: {"status": "sent" | "skipped" | "refused", "code", "reason"}. Decide on code: "not_a_member", "bad_text", "off", "outside_slot", "already_sent", "nobody", "all_failed", "error".

m.spend

Record a paid unit of a service before the call that spends it.

Signature

m.spend(vendor, units=1, *, key)

Example · Inside a job

paid = m.spend("example", 1, key="lookup:41")
if paid.get("code") in ("recorded", "duplicate"):
    r = m.fetch("https://api.example.com/v1/lookup", key="example")

For a service the machine holds a key for. It spends nothing until the owner sets a monthly limit for that key, next to the key on the machine's Keys page: until then the answer is no_cap. The limit is in the service's own units, per billing cycle. The same key is counted once, so a retry never pays twice. Never raises.

Needs in machine.yaml: keys: [...], and the owner's monthly limit for that key
Returns: {"status": "recorded" | "duplicate" | "refused", "code", "reason", "left"}. Decide on code: "recorded", "duplicate", "no_cap", "over_cap", "not_granted", "bad_units", "bad_key". left is what this cycle's limit has left.