callwright 1.0.0

package/place_call.schema.json

@@ -0,0 +1,173 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "place_call",
+  "description": "Place an outbound phone call on the principal's behalf to accomplish a goal (e.g. a reservation or appointment). The assistant MUST collect every required field from the user before calling this tool. If a required field is missing or ambiguous, ASK the user — do not guess. DATA MINIMIZATION: in `principal.facts`, include ONLY the personal data plausibly needed for THIS specific call_type — never the user's whole profile. Choose the minimal subset (e.g. a repair-confirmation may need service_address; a dinner reservation needs none). PII CONVENTION: put personal/identifying data (address, member id, DOB, account number, etc.) in `principal.facts` (disclosed only if the business asks), and keep `request.scenario_details` for NON-PII call specifics (service_type, party_size, occasion). After assembling the arguments, read them back to the user in plain language — INCLUDING exactly which personal data types will be available to the agent (the names of the keys in principal.facts, plus name/callback_number) — and get confirmation before invoking. This tool is fire-and-forget: it returns a call_id immediately; the result is retrieved on demand via get_call_outcome (Retell is the system of record).",
+  "type": "object",
+  "required": ["call_type", "target", "principal", "request"],
+  "additionalProperties": false,
+  "properties": {
+
+    "call_type": {
+      "type": "string",
+      "description": "Open-ended scenario id, lowercase snake/kebab (e.g. 'haircut', 'restaurant_reservation', 'dentist_cleaning', 'general_inquiry'). If a matching scenario profile exists, it supplies recommended fields, default flexibility, direction hints, and confirm items. Unknown types fall back to generic behavior."
+    },
+
+    "target": {
+      "type": "object",
+      "description": "The business being called.",
+      "required": ["business_name", "phone_number"],
+      "additionalProperties": false,
+      "properties": {
+        "business_name": { "type": "string", "description": "Name of the business, used by the agent when speaking." },
+        "phone_number": {
+          "type": "string",
+          "description": "E.164 format, e.g. +15555550199. If the user gives a local format, normalize it and confirm.",
+          "pattern": "^\\+[1-9]\\d{6,14}$"
+        },
+        "timezone": { "type": "string", "description": "IANA tz of the business, e.g. America/New_York. Infer from area code if not given, then confirm." }
+      }
+    },
+
+    "principal": {
+      "type": "object",
+      "description": "The person the call is placed on behalf of. Stable identity + an OPEN grounding bag. This tool does not source grounding itself — the host LLM populates `facts` from the user's standing profile and/or other connected MCPs (WorkIQ, Gmail, calendar, CRM, etc.).",
+      "required": [],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "description": "Name to give for the reservation/appointment. OPTIONAL — omit for general inquiries where no booking/identity is involved, so the agent does not attach the principal's name to the call." },
+        "anonymous": { "type": "boolean", "description": "Set true for a truly nameless call (general inquiries). Suppresses backfill of name/callback_number from config and places the call with NO principal identity. Default false (basics are backfilled for convenience)." },
+        "callback_number": {
+          "type": "string",
+          "description": "E.164. The agent only shares this if the business asks. Mark in do_not_volunteer if it should never be offered proactively.",
+          "pattern": "^\\+[1-9]\\d{6,14}$"
+        },
+        "facts": {
+          "type": "object",
+          "description": "MINIMAL per-call subset of standing facts about the principal that the agent may share ONLY IF the business asks (never volunteer). Keys are snake_case labels the agent speaks humanized (e.g. service_address, account_number, date_of_birth, member_id, vehicle, insurance_provider, loyalty_number). Values are strings/numbers/booleans. DATA MINIMIZATION: include ONLY what THIS call_type plausibly needs — do NOT dump the user's full profile. The host LLM selects this subset from the user's standing profile and/or connected context MCPs (WorkIQ, Gmail, calendar, CRM). This is the right home for PII: anything identifying belongs here (only-if-asked + surfaced in the read-back), NOT in scenario_details. Distinct from request.scenario_details (non-PII call specifics).",
+          "additionalProperties": { "type": ["string", "number", "boolean"] }
+        }
+      }
+    },
+
+    "request": {
+      "type": "object",
+      "description": "What to actually accomplish. Shape these from the user's intent; ask for anything missing.",
+      "required": ["summary", "preferred"],
+      "additionalProperties": false,
+      "properties": {
+        "summary": {
+          "type": "string",
+          "description": "One sentence the agent can act on, e.g. 'Dinner reservation for 4'. For appointments, include the service, e.g. 'Routine dental cleaning'."
+        },
+        "opening_ask": {
+          "type": "string",
+          "description": "OPTIONAL. The first thing the agent says after disclosing it's an AI — leads with the goal/need, e.g. \"I'm calling to confirm an appointment. Could you help me with that?\". If omitted, one is derived from `summary`. Do NOT phrase as 'is now a good time?'."
+        },
+        "party_size": { "type": "integer", "minimum": 1, "description": "Required for reservations. Number of people." },
+        "max_party_size": { "type": "integer", "minimum": 1, "description": "Negotiation ceiling; agent will not accept a larger booking. Defaults to party_size if omitted." },
+        "preferred": {
+          "type": "object",
+          "description": "The first-choice date/time. The agent aims for this before falling back. If acceptable_windows is omitted, a single window is derived from this plus the flexibility minutes.",
+          "required": ["date", "time"],
+          "additionalProperties": false,
+          "properties": {
+            "date": { "type": "string", "format": "date", "description": "YYYY-MM-DD. Resolve relative dates ('Saturday') against the business timezone and confirm the absolute date." },
+            "time": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$", "description": "24h HH:MM." }
+          }
+        },
+        "acceptable_windows": {
+          "type": "array",
+          "description": "OPTIONAL ordered fallback ladder. The agent negotiates DOWN this list and accepts nothing outside it. If omitted, one window is derived from `preferred` +/- the flexibility minutes (default 45). Provide explicitly when the user names multiple fallback dates/times.",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["date", "earliest", "latest"],
+            "additionalProperties": false,
+            "properties": {
+              "date": { "type": "string", "format": "date" },
+              "earliest": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" },
+              "latest": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }
+            }
+          }
+        }
+      }
+    },
+
+    "scenario_details": {
+      "type": "object",
+      "description": "NON-PII scenario specifics keyed by the matching profile (e.g. for 'haircut': stylist, service_type, hair_length; for a reservation: occasion). These are spoken PROACTIVELY by the agent during the call, so DO NOT put personal/identifying data here (address, member id, DOB, phone, account number) — that belongs in principal.facts (only-if-asked). The profile lists which keys are recommended; the dispatcher warns when recommended keys are missing and speaks the provided ones during the call. Open-ended bag — any string/number/boolean values allowed.",
+      "additionalProperties": { "type": ["string", "number", "boolean"] }
+    },
+
+    "preferences": {
+      "type": "array",
+      "description": "Nice-to-haves, ranked. Never blockers. e.g. 'Quieter table', 'Patio over bar'.",
+      "items": { "type": "string" }
+    },
+
+    "constraints": {
+      "type": "array",
+      "description": "Things the agent must proactively raise/verify, e.g. 'Nut allergy — confirm kitchen can accommodate', 'Wheelchair access needed'.",
+      "items": { "type": "string" }
+    },
+
+    "must_confirm": {
+      "type": "array",
+      "description": "Fields the agent reads back to the business before ending the call. Defaults to date, time, party_size, name.",
+      "items": { "type": "string" }
+    },
+
+    "do_not_volunteer": {
+      "type": "array",
+      "description": "Facts the agent may USE if asked but must NOT offer proactively (PII minimization). e.g. 'callback_number'.",
+      "items": { "type": "string" }
+    },
+
+    "anticipated_qa": {
+      "type": "array",
+      "description": "Pre-answers to likely business questions, to avoid awkward pauses. Optional but improves call quality.",
+      "items": {
+        "type": "object",
+        "required": ["q", "a"],
+        "additionalProperties": false,
+        "properties": {
+          "q": { "type": "string" },
+          "a": { "type": "string" }
+        }
+      }
+    },
+
+    "overrides": {
+      "type": "object",
+      "description": "Optional per-call overrides of the direction template defaults. Omit to use template defaults.",
+      "additionalProperties": false,
+      "properties": {
+        "time_flexibility_minutes": { "type": "integer", "minimum": 0 },
+        "disclose_ai": { "type": "boolean", "description": "Default true. Do not set false without a legal reason." },
+        "record_audio": { "type": "boolean", "description": "Default false. If true, agent must speak a consent line." },
+        "max_call_duration_seconds": { "type": "integer", "minimum": 30 },
+        "on_voicemail": { "type": "string", "enum": ["leave_message", "hang_up"] },
+        "retry": {
+          "type": "object",
+          "description": "Retry-on-no-answer policy. Defaults to exactly 1 retry; never raise max_retries above 1 without an explicit user request (repeated calls are spammy).",
+          "additionalProperties": false,
+          "properties": {
+            "max_retries": { "type": "integer", "minimum": 0, "maximum": 5, "description": "Number of re-dials on no-answer. Default 1. >1 only on explicit user request." },
+            "on": { "type": "array", "items": { "type": "string", "enum": ["no_answer", "busy", "failed"] } },
+            "delay_seconds": { "type": "integer", "minimum": 0, "maximum": 600 }
+          }
+        }
+      }
+    },
+
+    "notify": {
+      "type": "object",
+      "description": "Optional per-call 'text me when it's done'. Off by default — results are pulled on demand via get_call_outcome. Only set sms:true if the user asks to be notified.",
+      "additionalProperties": false,
+      "properties": {
+        "sms": { "type": "boolean", "description": "True = send the user an SMS when this call completes." },
+        "to": { "type": "string", "description": "The user's own number to text (E.164). If omitted, uses the saved notify number; if none, ask the user." }
+      }
+    }
+  }
+}

package/providers/README.md

@@ -0,0 +1,116 @@
+# Provider abstraction (evaluated — Retell retained)
+
+> **Decision (2026-06-23): stay on Retell.** This document is kept as (a) a record of the
+> ElevenLabs evaluation and (b) a ready blueprint if we ever add a second provider. The live
+> code is intentionally **not** refactored behind this interface — Retell is a direct,
+> well-contained dependency.
+>
+> **Why Retell over ElevenLabs**, despite ElevenLabs' stronger voice/multilingual:
+> 1. **Adoptability** — Retell is one self-contained platform ("paste API key, buy a number,
+>    done"). ElevenLabs Agents needs a separate **BYO Twilio** account/number/billing, which is
+>    real friction for an OSS tool meant for others to clone and run.
+> 2. **Pay-as-you-go, no monthly floor** — Retell bills per-minute with no commitment, ideal for
+>    a personal tool placing a handful of calls/month. ElevenLabs Agents pricing is
+>    plan/subscription-oriented (a monthly floor).
+> 3. **No capability gap** — Retell does everything we need (incl. IVR/`press_digit`); ElevenLabs'
+>    edges (voice warmth, multilingual STT, `language_detection`) are quality improvements, not
+>    blockers. They're documented below as a **fallback** if those ever become the dominant pain.
+
+Callwright's "brain" (job schema, scenario profiles, grounding/direction composition,
+disclosure & negotiation rules in the prompts, the 7 MCP tools, the learning loop) is
+**platform-agnostic**. Only the *actuator* — the part that actually provisions agents and
+dials phones — is platform-specific.
+
+Today that actuator is **Retell**, reached via plain REST. This document defines the small
+interface a provider must implement so the actuator becomes pluggable (Retell **or**
+ElevenLabs, selected by a `CALLWRIGHT_PROVIDER` env var).
+
+The actuator surface is tiny — **5 methods**. Everything else is reused unchanged.
+
+## The interface
+
+```js
+// providers/<name>.js
+module.exports = {
+  // 1. Verify credentials; return the list of existing agents.
+  async verifyKey(key) -> Agent[],
+
+  // 2. List/resolve the outbound caller number.
+  async resolveFromNumber(key, preferred) -> { from_number, numbers, needsChoice?, reason? },
+
+  // 3. Reuse-or-create the generic agent from a prompt file + voice + language.
+  //    Bakes in the call behavior (wait-for-greeting, IVR/DTMF tool, voicemail,
+  //    hold tolerance, post-call analysis fields).
+  async ensureGenericAgent(key, { agents, defaultId, promptFile, voiceId, lang }) -> { agent_id, created, reused },
+
+  // 4. Place one outbound call, injecting per-call grounding as {{variables}}.
+  async placeCall({ key, from, to, agentId, vars }) -> { call_id },
+
+  // 5. Fetch a completed call's outcome + transcript.
+  async getOutcome(key, callId) -> { status, disconnect, duration_s, analysis, transcript },
+};
+```
+
+## Method mapping: Retell (today) vs ElevenLabs
+
+| # | Method | **Retell** (current code) | **ElevenLabs** (verified equivalent) |
+|---|---|---|---|
+| 1 | `verifyKey` | `POST /v2/list-agents` (voice channel filter; paginated) | `GET /v1/convai/agents` (list agents) |
+| 2 | `resolveFromNumber` | `GET /v2/list-phone-numbers` (buy/list in-platform) | List imported numbers; **BYO Twilio/SIP** |
+| 3 | `ensureGenericAgent` | `POST /create-retell-llm` + `POST /create-agent` (voice_id, language, stt_mode, interruption_sensitivity, `press_digit` + `end_call` tools, voicemail_option, post_call_analysis_data) | `POST /v1/convai/agents/create` with `conversation_config` (prompt, first_message, voice, system tools: `play_keypad_touch_tone`, `voicemail_detection`, `language_detection`, `end_call`, `skip_turn`) |
+| 4 | `placeCall` | `POST /v2/create-phone-call` with `override_agent_id` + `retell_llm_dynamic_variables` | Outbound call API / batch-calls with per-call **dynamic variables** + overrides (`language`, `first_message`, `system_prompt`, `voice_id`) |
+| 5 | `getOutcome` | `GET /v2/get-call/{id}` → `call_analysis.custom_analysis_data` | Conversation analysis API → analysis fields |
+
+## What ports unchanged (the brain — ~70% of the code)
+
+- `place_call.schema.json` — the job contract
+- `scenario-profiles.json` + `learn.js` — profiles & learning loop
+- `dispatch-core.composeCall()` — grounding → `{{variables}}` (BOTH platforms use identical
+  `{{var}}` double-curly templating, so the composed output is portable verbatim)
+- `generic-prompt.md` / `.ja.md` — the agent prompts (same `{{var}}` syntax)
+- `server.js` — all 7 MCP tools, stateless HTTP, auth
+- `setup-core` config/status/guard helpers
+
+## What changes (the actuator — ~30%)
+
+- Current Retell calls in `dispatch-core.dispatchCall`, `setup-core.{verifyKey,listNumbers,
+  ensureGenericAgent}`, and `server.retell()`/`get-call.js` move behind `providers/<name>.js`.
+- `dispatch-core`/`setup-core` call `provider.X()` chosen by `CALLWRIGHT_PROVIDER`
+  (default `retell`).
+- `providers/retell.js` is a straight extraction of today's code (no behavior change).
+- `providers/elevenlabs.js` is the new implementation (~200–300 lines).
+
+## Behavior parity notes (ElevenLabs has NATIVE solutions to our hand-tuned pain points)
+
+| Callwright behavior (hand-tuned in Retell) | ElevenLabs native equivalent |
+|---|---|
+| `press_digit` for IVR menus | `play_keypad_touch_tone` (0-9,*,#, **pause control**, **out-of-band RFC 4733** — more robust) |
+| Wait for callee greeting (`start_speaker:user` + 8s) | `skip_turn` system tool + turn-taking config |
+| Voicemail handling (`voicemail_option`) | `voicemail_detection` system tool |
+| Bilingual JA/EN STT garbling (our worst issue) | `language_detection` system tool (auto-switch mid-call) |
+| `end_call` tool | `end_call` system tool |
+| post_call_analysis_data | conversation analysis |
+
+## Cost (rough, all-in per minute)
+
+| | Retell | ElevenLabs |
+|---|---|---|
+| Voice stack | ~$0.07–0.08/min (bundled) | $0.08/min flat (paid tier) |
+| LLM | passthrough | separate (credits) |
+| Telephony US | $0.015/min (bundled) | BYO Twilio ~$0.014/min |
+| Telephony Japan | $0.28/min (markup) | BYO Twilio ~$0.10–0.20/min raw |
+| **US call all-in** | ~$0.10–0.15/min | ~$0.10–0.14/min (≈ parity) |
+| **Japan call all-in** | ~$0.37–0.44/min | ~$0.20–0.30/min (cheaper) |
+
+Tradeoff: ElevenLabs is ≈ parity (US) / cheaper (intl) per-minute, but adds **BYO Twilio
+setup** + a small monthly plan floor. At personal volume, per-minute cost is pennies either
+way — choose on capability (voice warmth, multilingual), not price.
+
+## Status
+
+This is a **design contract only** — the live code is NOT yet refactored behind it (the
+production Retell path is untouched). Implementing it is a bounded follow-up:
+1. Extract `providers/retell.js` from current code (no behavior change) + verify/deploy.
+2. Add `CALLWRIGHT_PROVIDER` switch in `dispatch-core`/`setup-core`.
+3. Implement `providers/elevenlabs.js` + a Twilio number.
+4. A/B one real call per platform (esp. a bilingual Japanese call) before switching default.

package/retry-core.js

@@ -0,0 +1,121 @@
+// callwright — retry-on-no-answer core. Pure functions: classify a Retell
+// disconnection, parse a retry policy (DEFAULT = exactly 1 retry; never more
+// without an explicit per-call request — anti-spam), round-trip the policy +
+// attempt counter through the call's dynamic variables, and decide whether a
+// finished call should be re-dialed.
+//
+// The policy travels IN the call's dynamic vars (retry_max/retry_on/
+// retry_attempt/retry_delay), so the webhook can decide from the call_ended
+// payload alone — no job lookup — and the incrementing attempt counter makes
+// the retry chain self-terminating.
+
+const MAX_RETRY_CAP = 5;        // absolute ceiling, even on explicit request
+const MAX_DELAY_SECONDS = 600;  // 10 min (best-effort while the machine is warm)
+const DEFAULT_MAX_RETRIES = 1;  // <-- the anti-spam default: one retry, no more
+const DEFAULT_DELAY_SECONDS = 60;
+
+// Retell disconnection_reason -> coarse category.
+const REASON_CATEGORY = {
+  dial_no_answer: "no_answer",
+  no_answer: "no_answer",
+  dial_busy: "busy",
+  busy: "busy",
+  dial_failed: "failed",
+  failed: "failed",
+  voicemail_reached: "voicemail",
+  machine_detected: "voicemail",
+  voicemail: "voicemail",
+  user_hangup: "answered",
+  agent_hangup: "answered",
+  call_transfer: "answered",
+  inactivity: "answered",
+  max_duration_reached: "answered",
+  scam_detected: "blocked",
+  no_valid_payment: "blocked",
+  concurrency_limit_reached: "blocked",
+};
+
+function classifyDisconnect(reason) {
+  const r = String(reason || "").toLowerCase();
+  if (REASON_CATEGORY[r]) return REASON_CATEGORY[r];
+  if (r.startsWith("error")) return "error";
+  return "other";
+}
+
+// Categories that retry can act on (no-answer / busy / transient failure).
+const DEFAULT_ON = ["no_answer", "busy", "failed"];
+
+function normalizeCategory(token) {
+  const t = String(token || "").toLowerCase();
+  return REASON_CATEGORY[t] || (DEFAULT_ON.includes(t) ? t : (t === "voicemail" ? "voicemail" : t));
+}
+
+function clamp(n, lo, hi) { return Math.max(lo, Math.min(hi, n)); }
+
+function parseRetryPolicy(overridesRetry) {
+  const o = overridesRetry || {};
+  const rawMax = (o.max_retries === undefined || o.max_retries === null) ? DEFAULT_MAX_RETRIES : Number(o.max_retries);
+  const maxRetries = Number.isFinite(rawMax) ? clamp(Math.trunc(rawMax), 0, MAX_RETRY_CAP) : DEFAULT_MAX_RETRIES;
+  const rawDelay = (o.delay_seconds === undefined || o.delay_seconds === null) ? DEFAULT_DELAY_SECONDS : Number(o.delay_seconds);
+  const delaySeconds = Number.isFinite(rawDelay) ? clamp(Math.trunc(rawDelay), 0, MAX_DELAY_SECONDS) : DEFAULT_DELAY_SECONDS;
+  const onList = Array.isArray(o.on) && o.on.length ? o.on.map(normalizeCategory) : DEFAULT_ON.slice();
+  return { maxRetries, delaySeconds, on: new Set(onList) };
+}
+
+function policyToVars(policy, attempt = 0) {
+  return {
+    retry_max: String(policy.maxRetries),
+    retry_on: [...policy.on].join(","),
+    retry_delay: String(policy.delaySeconds),
+    retry_attempt: String(attempt),
+  };
+}
+
+function readPolicyVars(vars) {
+  const v = vars || {};
+  if (v.retry_max === undefined || v.retry_max === null || v.retry_max === "") return null; // no policy present
+  const on = new Set(String(v.retry_on || "").split(",").map((s) => s.trim()).filter(Boolean).map(normalizeCategory));
+  return {
+    maxRetries: clamp(parseInt(v.retry_max, 10) || 0, 0, MAX_RETRY_CAP),
+    delaySeconds: clamp(parseInt(v.retry_delay, 10) || 0, 0, MAX_DELAY_SECONDS),
+    attempt: parseInt(v.retry_attempt, 10) || 0,
+    on,
+  };
+}
+
+// Decide whether a finished call should be retried. Pure: reads the call's
+// disconnection_reason + retry_* dynamic vars. Returns the NEXT attempt number.
+function decideRetry(call) {
+  const reason = call && call.disconnection_reason;
+  const category = classifyDisconnect(reason);
+  const policy = readPolicyVars(call && call.retell_llm_dynamic_variables);
+  if (!policy) return { retry: false, reason: "no_policy", category };
+  if (policy.maxRetries <= 0) return { retry: false, reason: "max_retries_reached", category, maxRetries: policy.maxRetries };
+  if (!policy.on.has(category)) return { retry: false, reason: "not_retryable", category };
+  if (policy.attempt >= policy.maxRetries) return { retry: false, reason: "max_retries_reached", category, attempt: policy.attempt, maxRetries: policy.maxRetries };
+  return {
+    retry: true,
+    attempt: policy.attempt + 1,
+    maxRetries: policy.maxRetries,
+    delaySeconds: policy.delaySeconds,
+    category,
+  };
+}
+
+// Vars for the re-dial: same vars, attempt bumped so the chain self-terminates.
+function buildRetryVars(vars, attempt) {
+  return { ...(vars || {}), retry_attempt: String(attempt) };
+}
+
+// A one-line human summary for the read-back.
+function describePolicy(policy) {
+  if (!policy || policy.maxRetries <= 0) return "off (no automatic retry)";
+  const on = [...policy.on].join("/");
+  return `up to ${policy.maxRetries} on ${on} (after ${policy.delaySeconds}s, best-effort)`;
+}
+
+module.exports = {
+  MAX_RETRY_CAP, MAX_DELAY_SECONDS, DEFAULT_MAX_RETRIES, DEFAULT_DELAY_SECONDS, DEFAULT_ON,
+  classifyDisconnect, parseRetryPolicy, policyToVars, readPolicyVars,
+  decideRetry, buildRetryVars, describePolicy,
+};

package/scenario-profiles.json

@@ -0,0 +1,112 @@
+{
+  "haircut": {
+    "aliases": [
+      "haircut",
+      "hair_cut",
+      "salon",
+      "barber",
+      "hair"
+    ],
+    "default_flex_minutes": 60,
+    "recommended_details": {
+      "stylist": "Preferred stylist name, or 'first available'",
+      "service_type": "Type of service requested"
+    },
+    "must_confirm": [
+      "the date",
+      "the time",
+      "the service",
+      "the stylist if specified"
+    ],
+    "learned": []
+  },
+  "restaurant_reservation": {
+    "aliases": [
+      "restaurant",
+      "reservation",
+      "dinner",
+      "table"
+    ],
+    "default_flex_minutes": 45,
+    "recommended_details": {
+      "party_size": "Number of people",
+      "occasion": "Special occasion, if any (else none)"
+    },
+    "must_confirm": [
+      "the party size",
+      "the date",
+      "the time"
+    ],
+    "learned": []
+  },
+  "dentist": {
+    "aliases": [
+      "dentist",
+      "dental",
+      "cleaning",
+      "orthodontist"
+    ],
+    "default_flex_minutes": 120,
+    "recommended_details": {
+      "service_type": "e.g. routine cleaning, filling, checkup",
+      "new_or_existing": "New patient or existing patient",
+      "insurance": "Insurance provider, if they may ask"
+    },
+    "must_confirm": [
+      "the date",
+      "the time",
+      "the service",
+      "the patient name"
+    ],
+    "learned": []
+  },
+  "appointment_confirmation": {
+    "aliases": [
+      "appointment_confirmation",
+      "confirm_appointment",
+      "confirmation",
+      "service_appointment",
+      "repair",
+      "service_call"
+    ],
+    "default_flex_minutes": 0,
+    "recommended_details": {
+      "service_address": "Service/site address used to look up the appointment",
+      "service_type": "What the appointment is for (e.g. stove repair)"
+    },
+    "must_confirm": [
+      "the date",
+      "the appointment window",
+      "the name"
+    ],
+    "learned": []
+  },
+  "hotel_transport_inquiry": {
+    "aliases": [
+      "hotel_transport_inquiry",
+      "hotel_transport",
+      "hire_car",
+      "hired_car",
+      "car_service",
+      "airport_transfer",
+      "limousine",
+      "haiya",
+      "shuttle"
+    ],
+    "default_flex_minutes": 0,
+    "recommended_details": {
+      "destination": "Where the car is going (e.g. the airport name), or pickup+dropoff",
+      "pickup_time": "Desired pickup date/time, if booking; omit for a pure price inquiry",
+      "passengers": "Number of passengers",
+      "luggage": "Number/size of bags, if relevant to vehicle choice",
+      "vehicle_preference": "Sedan / van / luxury, if the caller has a preference"
+    },
+    "must_confirm": [
+      "the destination",
+      "the price",
+      "what the price includes (tax, tolls)",
+      "the vehicle type"
+    ],
+    "learned": []
+  }
+}