| name | find_known_provider |
| description | Find a provider the user already uses (contacts + invoices + events) before searching nearby. |
| when_to_use | Whenever the user mentions a service provider category ("Zahnarzt",
"Hausarzt", "Werkstatt", "Friseur", "Steuerberater") without naming
one specifically. Yorik should check what the user already has on
file before suggesting new ones.
Examples:
"Zahnarzttermin am Dienstag" → find_known_provider(category="dentist")
"ich muss zum Optiker" → find_known_provider(category="optician")
"Termin beim Friseur" → find_known_provider(category="hairdresser")
Three places get checked, in order of trust:
1. Contacts — anyone with relation matching ("mein Zahnarzt", "Frau
Dr. Schmidt"), kind='business' + a relevant keyword in the name
("Zahnarztpraxis Müller"), or a category tag.
2. Paperless — past invoices/letters with correspondents matching
the category (e.g. correspondent name contains "Zahnarzt").
3. Past calendar events — titles containing the category that have
a location set.
Outcomes:
- 1 known → return them; LLM proceeds directly to add_calendar_event
- >1 known → ask user which (relation? last-visited?) — do NOT silently pick the highest-trust source.
- 0 known → fall through to find_provider_nearby(poi=…, near=…)
|
| inputs | {"category":{"type":"string","required":true,"description":"Service category. Yorik recognises (case-insensitive, EN+DE):\ndentist/zahnarzt, doctor/hausarzt/arzt, pharmacy/apotheke,\nhospital/krankenhaus, veterinary/tierarzt, optician/optiker,\nhairdresser/friseur, garage/werkstatt, lawyer/anwalt,\ntax_advisor/steuerberater, accountant/buchhalter.\n"}} |
| outputs | {"candidates":{"type":"array","description":"List of {source: \"contact\"|\"paperless\"|\"calendar\", contact_id?,\nname, address?, phone?, email?, last_seen?, evidence} — what we\nknow about them and where the info came from.\n"},"source_counts":{"type":"object","description":"{contacts: N, paperless: N, calendar: N} for quick triage."}} |
| permissions | ["admin","member","restricted"] |
| side_effects | none — read only. |
| tags | ["contacts","paperless","calendar","provider","search"] |
find_known_provider
Defence-in-depth before reaching out to the open internet. The user's
own data has higher trust than a random Overpass result, and Yorik
should remember the dentist they invoiced last year.
