@agenticmail/core 0.9.31 → 0.9.33

package/dist/index.cjs

@@ -9828,7 +9828,7 @@ var GatewayManager = class {
    * agent's INBOX via the existing local-SMTP path — the very same
    * delivery the relay uses for real email. This makes the existing
    * IMAP IDLE → claudecode dispatcher path light up exactly as it
-   * would for a real inbound mail, so the agent gets a Claude turn
+   * would for a real inbound mail, so the agent gets a host turn
    * without any new dispatcher plumbing. The body of the synthetic
    * mail tells the agent the message came from Telegram and that it
    * MUST reply via the `telegram_send` MCP tool, not via email.

package/dist/index.d.cts

@@ -364,7 +364,7 @@ interface Agent {
      *  this agent on every CC-only delivery regardless of the
      *  sender's `wake` list. Coder/silent-observer agents register
      *  with `wake_on_cc: false` so a designer's `cc:` accidentally
-     *  including them never wastes a Claude turn. Defaults to true
+     *  including them never wastes a host turn. Defaults to true
      *  (preserves the 0.9.0 wake-list-respecting behaviour). */
     wakeOnCc?: boolean;
     /** Soft-stop flag. When true, the dispatcher refuses to wake
@@ -1836,7 +1836,7 @@ declare class GatewayManager {
      * agent's INBOX via the existing local-SMTP path — the very same
      * delivery the relay uses for real email. This makes the existing
      * IMAP IDLE → claudecode dispatcher path light up exactly as it
-     * would for a real inbound mail, so the agent gets a Claude turn
+     * would for a real inbound mail, so the agent gets a host turn
      * without any new dispatcher plumbing. The body of the synthetic
      * mail tells the agent the message came from Telegram and that it
      * MUST reply via the `telegram_send` MCP tool, not via email.
@@ -5951,7 +5951,7 @@ interface Skill {
     extra?: Record<string, unknown>;
 }
 /** Coarse-grained taxonomy. Extend ONLY via PR + a reviewer's nod. */
-type SkillCategory = 'negotiation' | 'customer-service' | 'reservations' | 'medical-admin' | 'legal-admin' | 'finance-admin' | 'real-estate' | 'travel' | 'subscription' | 'home-services' | 'social' | 'civic' | 'employment' | 'debt-collection' | 'other';
+type SkillCategory = 'negotiation' | 'customer-service' | 'reservations' | 'medical-admin' | 'legal-admin' | 'finance-admin' | 'real-estate' | 'travel' | 'subscription' | 'home-services' | 'social' | 'civic' | 'employment' | 'debt-collection' | 'emergency-services' | 'critical-reasoning' | 'emotional-intelligence' | 'closing' | 'outreach' | 'professional-services' | 'education' | 'tenancy' | 'utility-telecom' | 'insurance' | 'other';
 /** When-to-use + preconditions block. */
 interface SkillContext {
     /** Plain-language description of the situation this skill fits. */

package/dist/index.d.ts

@@ -364,7 +364,7 @@ interface Agent {
      *  this agent on every CC-only delivery regardless of the
      *  sender's `wake` list. Coder/silent-observer agents register
      *  with `wake_on_cc: false` so a designer's `cc:` accidentally
-     *  including them never wastes a Claude turn. Defaults to true
+     *  including them never wastes a host turn. Defaults to true
      *  (preserves the 0.9.0 wake-list-respecting behaviour). */
     wakeOnCc?: boolean;
     /** Soft-stop flag. When true, the dispatcher refuses to wake
@@ -1836,7 +1836,7 @@ declare class GatewayManager {
      * agent's INBOX via the existing local-SMTP path — the very same
      * delivery the relay uses for real email. This makes the existing
      * IMAP IDLE → claudecode dispatcher path light up exactly as it
-     * would for a real inbound mail, so the agent gets a Claude turn
+     * would for a real inbound mail, so the agent gets a host turn
      * without any new dispatcher plumbing. The body of the synthetic
      * mail tells the agent the message came from Telegram and that it
      * MUST reply via the `telegram_send` MCP tool, not via email.
@@ -5951,7 +5951,7 @@ interface Skill {
     extra?: Record<string, unknown>;
 }
 /** Coarse-grained taxonomy. Extend ONLY via PR + a reviewer's nod. */
-type SkillCategory = 'negotiation' | 'customer-service' | 'reservations' | 'medical-admin' | 'legal-admin' | 'finance-admin' | 'real-estate' | 'travel' | 'subscription' | 'home-services' | 'social' | 'civic' | 'employment' | 'debt-collection' | 'other';
+type SkillCategory = 'negotiation' | 'customer-service' | 'reservations' | 'medical-admin' | 'legal-admin' | 'finance-admin' | 'real-estate' | 'travel' | 'subscription' | 'home-services' | 'social' | 'civic' | 'employment' | 'debt-collection' | 'emergency-services' | 'critical-reasoning' | 'emotional-intelligence' | 'closing' | 'outreach' | 'professional-services' | 'education' | 'tenancy' | 'utility-telecom' | 'insurance' | 'other';
 /** When-to-use + preconditions block. */
 interface SkillContext {
     /** Plain-language description of the situation this skill fits. */

package/dist/index.js

@@ -8159,7 +8159,7 @@ var GatewayManager = class {
    * agent's INBOX via the existing local-SMTP path — the very same
    * delivery the relay uses for real email. This makes the existing
    * IMAP IDLE → claudecode dispatcher path light up exactly as it
-   * would for a real inbound mail, so the agent gets a Claude turn
+   * would for a real inbound mail, so the agent gets a host turn
    * without any new dispatcher plumbing. The body of the synthetic
    * mail tells the agent the message came from Telegram and that it
    * MUST reply via the `telegram_send` MCP tool, not via email.

package/dist/skills/built-in/accommodation-intake.json

@@ -0,0 +1,132 @@
+{
+  "id": "accommodation-intake",
+  "name": "Disability / Accommodation Services Intake",
+  "version": "1.0.0",
+  "category": "other",
+  "tags": [
+    "accommodation",
+    "disability",
+    "ADA",
+    "504",
+    "DSS",
+    "intake",
+    "phone-call",
+    "education"
+  ],
+  "description": "Call a college Disability Services / Accessibility / Student Accessibility Resources office to start an accommodation intake, request testing accommodations, housing accommodations, or note-taking / recording support — including for newly diagnosed conditions, temporary injuries, and undiagnosed-but-impacting concerns.",
+  "disclaimer": "Accommodations under ADA and Section 504 are granted based on documented disability + functional impact in the academic environment. The accommodations office determines what's reasonable, not the student or the faculty. This skill does not constitute legal advice; for denials, the Office for Civil Rights and disability-rights attorneys are formal recourse.",
+  "context": {
+    "when_to_use": "The user (a) has a recent or longstanding diagnosis (ADHD, learning disability, anxiety, depression, autism, chronic illness, mobility, vision, hearing, etc.) and hasn't yet registered with the disability office, (b) needs a temporary accommodation (broken arm, concussion, surgery recovery), (c) had high-school accommodations (IEP / 504) but they don't carry over, or (d) suspects they qualify but doesn't have documentation yet.",
+    "preconditions": [
+      "User has Student ID and contact info.",
+      "User can describe the functional impact in school terms: 'I can't sit for 50 minutes', 'I can't filter noise during tests', 'I freeze on timed exams', not just the diagnosis.",
+      "User has — or has a plan to obtain — documentation from a qualified provider. (IEP / 504 from K-12 is helpful but typically NOT sufficient on its own at the college level.)",
+      "User has reviewed the school's accommodation request form and intake calendar (some schools require 4–6 weeks lead time before testing accommodations are active)."
+    ],
+    "estimated_call_duration_minutes": 20
+  },
+  "principles": [
+    "Diagnosis is necessary but not sufficient — the office needs to see FUNCTIONAL IMPACT in the academic environment. Lead with impact, support with diagnosis.",
+    "The first call is intake, not approval. The goal is to open a file, get the documentation list, and book the substantive meeting with a Disability Services Coordinator.",
+    "Accommodations are forward-looking. They don't usually fix a grade you already earned. Register the moment you suspect you'll need them — earlier is always better.",
+    "K-12 IEP / 504 plans do NOT carry over to college. The student now has to self-disclose and re-document. This surprises a lot of families.",
+    "Faculty don't decide accommodations. Disability Services issues a letter; faculty are required to honor it. If a professor pushes back, the office advocates for you — that's their job.",
+    "If the user lacks documentation but has impact, ask about 'provisional' or 'interim' accommodations and the office's referral list for testing providers (some schools subsidize testing)."
+  ],
+  "phrases": {
+    "opener_new": "Hi, I'd like to start an intake with your office. I [have a diagnosis of / suspect I have] [condition] and it's affecting [specific academic task]. What's the process to get registered, and what's the realistic timeline?",
+    "opener_temporary": "Hi, I had [injury / surgery] on [date] and I need temporary accommodations for the next [duration]. Can you walk me through what your office offers and how fast we can put it in place?",
+    "ask_about_documentation": "What specifically do you need from a provider? Is there a form they should fill out, or a list of required elements (testing, diagnosis date, functional impact, recommended accommodations)?",
+    "ask_about_interim": "While I'm gathering documentation, are interim or provisional accommodations available? I have an exam on [date] and I'm worried about gap coverage.",
+    "ask_about_testing_referrals": "I don't currently have a recent psychoeducational evaluation. Does your office have a list of providers who test, and any subsidies or sliding-scale options?",
+    "ask_about_housing": "I'd also like to request housing accommodation for [reason — single, AC, ground floor, ESA, etc.]. Is that a separate process or part of the same intake?",
+    "name_specific_accommodations": "Based on my history, what's typically been effective is: extended time on tests (1.5x or 2x), distraction-reduced testing environment, lecture recording permission, note-taking support, flexible attendance, and assignment-deadline flexibility. Can we discuss which of these would be reasonable in my case?",
+    "ask_for_director": "Could I speak with the Director or an Associate Director of your office? I want to make sure the file is set up correctly and that I understand the appeal process if any accommodation is denied.",
+    "graceful_close_success": "Thank you. To confirm: intake meeting scheduled for [date] with [name], documentation list is [items], and I should expect my accommodation letter by [date]. May I have your direct email?"
+  },
+  "tactics": [
+    {
+      "name": "Lead with functional impact, support with diagnosis",
+      "when": "Describing the situation to the intake coordinator.",
+      "script": "Frame it as: 'When I [academic task], I [specific impact], because of [diagnosis or working hypothesis].' Office staff are trained on impact-based determination — diagnosis alone doesn't establish disability under ADA.",
+      "priority": 1
+    },
+    {
+      "name": "Book the intake meeting same-call",
+      "when": "First call.",
+      "script": "Don't leave the call without a calendar slot with a Coordinator. Many offices have 2-4 week wait lists; getting on the calendar is the actual win of this call.",
+      "priority": 2
+    },
+    {
+      "name": "Get the documentation checklist in writing",
+      "when": "Office describes what's required.",
+      "script": "Ask them to email the documentation requirements. Providers waste weeks producing letters that miss the school's required elements (date of testing, scores, DSM criteria, functional impact, recommended accommodations).",
+      "priority": 3
+    },
+    {
+      "name": "Ask about interim accommodations explicitly",
+      "when": "Documentation is pending but an exam or deadline is imminent.",
+      "script": "Use `ask_about_interim`. Many schools allow 30–60 days of interim accommodations on the basis of a provider's brief letter or pending evaluation — but only if you ask.",
+      "priority": 4
+    },
+    {
+      "name": "Bundle housing, testing, and classroom accommodations",
+      "when": "User has multiple needs.",
+      "script": "Use `ask_about_housing`. Housing accommodations (single room, AC, ESA, ground floor) often have separate deadlines (months before move-in) and separate documentation. Surface them all at intake.",
+      "priority": 5
+    },
+    {
+      "name": "Name common accommodations the office may not volunteer",
+      "when": "Discussing what accommodations might apply.",
+      "script": "Use `name_specific_accommodations`. Offices sometimes only offer extended time + distraction-reduced testing as defaults. Lecture recording, note-takers, flexible deadlines, and reduced-course-load status are equally available and rarely surfaced unsolicited.",
+      "priority": 6
+    },
+    {
+      "name": "Escalate to Director on denial",
+      "when": "An accommodation is denied or the request gets stuck.",
+      "script": "Use `ask_for_director`. There's usually an internal appeal process, and the Director has authority to override Coordinator-level decisions. Past that: the ADA Coordinator for the institution, then Office for Civil Rights complaint."
+    }
+  ],
+  "boundaries": [
+    "Do NOT disclose more medical detail than necessary. The office needs enough to verify a disability — they do not need a full history. Provider letters are the right channel for clinical detail.",
+    "Do NOT promise faculty anything about accommodations on the call — the office issues letters, faculty don't negotiate.",
+    "Do NOT use someone else's accommodations or letter — schools verify and the consequence is academic misconduct.",
+    "Do NOT skip registering 'because the semester is almost over' — register now for the next term; accommodations rarely apply retroactively to existing grades.",
+    "Do NOT make legal threats casually. They can be appropriate (ADA / Section 504 / OCR) but only after internal appeal."
+  ],
+  "success_signals": [
+    "Intake appointment booked.",
+    "Documentation checklist arrives by email.",
+    "Interim accommodations are confirmed in writing for the gap period.",
+    "Coordinator name and direct email are captured.",
+    "Office volunteers accommodations the user hadn't asked for."
+  ],
+  "failure_signals": [
+    "Office insists IEP / 504 from K-12 is sufficient without re-evaluation (it usually isn't at college level — push back).",
+    "Wait time for intake exceeds 6 weeks and no interim coverage offered.",
+    "Office tells user to 'talk to your professor' instead of issuing a formal accommodation — that's a misroute; the office's job is to issue the letter.",
+    "Documentation is rejected and the office won't specify what additional elements are needed.",
+    "Specific accommodation denied without written rationale or appeal pathway."
+  ],
+  "exit_strategy": {
+    "on_success": "Confirm intake date, Coordinator name, documentation requirements, interim coverage if any, and target letter-issuance date. Get the direct email.",
+    "on_failure": "Get any denial in writing with reasoning. Pathways: internal appeal to Director, ADA Coordinator for the institution, Office for Civil Rights complaint. Also consider a disability-rights legal aid org for a free consult before escalating.",
+    "follow_ups": [
+      "Email operator the documentation checklist and intake date.",
+      "Confirm provider letter is in draft and matches the school's required elements before submission.",
+      "Calendar 7 days after intake to confirm letter arrived.",
+      "Once letter is issued, email it to instructors at the start of each term — accommodations don't auto-deploy."
+    ]
+  },
+  "required_user_info": [
+    "Student ID and current term",
+    "Diagnosis (or working hypothesis) + provider name",
+    "Functional impact in academic terms",
+    "Whether documentation exists, is in progress, or is needed",
+    "K-12 IEP / 504 history if applicable",
+    "Specific upcoming deadlines (exams, papers, housing application)",
+    "Any accommodations previously used at another institution"
+  ],
+  "contributed_by": "education-admin agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:09:47Z"
+}

package/dist/skills/built-in/add-driver-vehicle-household.json

@@ -0,0 +1,133 @@
+{
+  "id": "add-driver-vehicle-household",
+  "name": "Add a New Driver, Vehicle, or Household Member Mid-Policy",
+  "version": "1.0.0",
+  "category": "finance-admin",
+  "tags": [
+    "auto",
+    "home",
+    "policy-change",
+    "endorsement",
+    "household",
+    "phone-call",
+    "insurance"
+  ],
+  "description": "Add a driver, vehicle, or household member to an existing policy mid-term. Confirm effective date, get the pro-rated premium impact in writing BEFORE binding, and avoid common traps: undisclosed-driver exclusions, garage-location mismatches, and surprise re-rating of the rest of the policy.",
+  "disclaimer": "Agent must NEVER admit fault, NEVER agree to a settlement on the operator's behalf, NEVER speculate about prior conditions, NEVER sign a release. All of those route through ask_operator.",
+  "context": {
+    "when_to_use": "User has a new driver (teen, spouse, household member), new vehicle (purchase, lease, gift), or new household composition (move-in roommate, college student returning) and wants to add them to an existing policy.",
+    "preconditions": [
+      "Existing policy number and named-insured info.",
+      "Full legal name, DOB, and driver's license number + state for new drivers.",
+      "VIN, year/make/model, lien holder info for new vehicles.",
+      "Garaging address (where the vehicle is parked overnight ≥ 50% of the time).",
+      "Date the change should be effective."
+    ],
+    "estimated_call_duration_minutes": 20
+  },
+  "principles": [
+    "Undisclosed drivers in the household are the #1 cause of post-loss coverage denials. Disclose, even when the rate goes up.",
+    "Effective date matters. Coverage gaps before the effective date can void claims; coverage backdates are often refused.",
+    "Adding a driver re-rates the WHOLE policy. Ask for the new total premium, not just the 'driver portion'.",
+    "Garaging address must match where the vehicle actually sits at night — misrepresenting it is rate fraud.",
+    "Lienholders and lessors require specific coverages (full coverage + lienholder-as-loss-payee). Confirm the lienholder info is added correctly or the lender will force-place coverage.",
+    "Get the binding confirmation and premium impact in writing BEFORE the call ends. 'I'll send the endorsement later' too often becomes a surprise bill."
+  ],
+  "phrases": {
+    "opener": "Hi, I'd like to add a [driver / vehicle / household member] to policy [number], effective [date]. Could you walk me through what you need and quote the premium change before binding anything?",
+    "ask_premium_impact": "Before we bind this — what does the total new policy premium look like, and what's the pro-rated amount due for the remainder of the term? Could you break out which portion is the new driver/vehicle and which is any re-rate of the existing coverage?",
+    "confirm_effective_date": "I want the change effective [date] — not the call date. Can you confirm that's how it'll bind, and what happens between now and the effective date?",
+    "ask_undisclosed_driver_consequences": "Out of curiosity, if a household member or vehicle had been driving the car for some time without being on the policy, how would the carrier treat that? Just want to understand the rules so we're clear going forward.",
+    "ask_lienholder": "The new vehicle is financed through [lender]. Could you add [lender] as loss payee/lienholder, and what's the form they need for proof of insurance?",
+    "ask_garaging": "The vehicle's primary garaging address is [address] — that's where it sits overnight most nights. Please make sure that's reflected on the endorsement, not just the named-insured's address.",
+    "ask_discount_eligibility": "Does adding this driver/vehicle unlock or change any discounts — multi-vehicle, multi-policy, good student, defensive driver, telematics?",
+    "request_written_quote": "Could you email or text me the endorsement quote and the new declarations page before we bind it? I'd like to review the numbers before committing.",
+    "graceful_close": "Thanks. To confirm: endorsement effective [date], new total premium [amount], pro-rated additional charge [amount], lienholder [added/N-A], declarations page emailed by [date]. We haven't bound yet — I'll confirm after I see the quote."
+  },
+  "tactics": [
+    {
+      "name": "Ask for the premium impact BEFORE binding",
+      "when": "Mid-call.",
+      "script": "Use the `ask_premium_impact` phrase. Reps often bind first and quote later. That denies the user the option to shop. Quote-then-bind is the right order.",
+      "priority": 1
+    },
+    {
+      "name": "Disclose accurately, even when the rate stings",
+      "when": "Adding a household driver.",
+      "script": "Be honest about driving frequency, license status, and any tickets/accidents. The alternative — undisclosed driver — voids coverage when it matters most.",
+      "priority": 2
+    },
+    {
+      "name": "Lock the effective date",
+      "when": "Confirming the change.",
+      "script": "Use the `confirm_effective_date` phrase. If the new driver needs coverage today, effective date is today. If they don't start driving until next month, effective date is next month — don't pay sooner than needed.",
+      "priority": 3
+    },
+    {
+      "name": "Add the lienholder correctly",
+      "when": "Adding a financed vehicle.",
+      "script": "Use the `ask_lienholder` phrase. Lender's name, address, loan number. Force-placed insurance (when the lender adds its own coverage because yours is missing) costs 3-5× the standard rate.",
+      "priority": 4
+    },
+    {
+      "name": "Set garaging accurately",
+      "when": "Adding a vehicle.",
+      "script": "Use the `ask_garaging` phrase. ZIP code drives rate. Misrepresenting garaging is fraud; under-representing it (claiming a low-cost ZIP for a vehicle that lives in a high-cost ZIP) is the most common version.",
+      "priority": 5
+    },
+    {
+      "name": "Surface discounts",
+      "when": "Late in the call.",
+      "script": "Use the `ask_discount_eligibility` phrase. Multi-vehicle, multi-policy, good student, telematics, defensive driver course, paid-in-full — these stack and can offset much of the increase.",
+      "priority": 6
+    },
+    {
+      "name": "Get the quote in writing",
+      "when": "Before binding.",
+      "script": "Use the `request_written_quote` phrase. Don't authorize binding until the declarations page (or at minimum a written quote with the new total premium) is in hand.",
+      "priority": 7
+    }
+  ],
+  "boundaries": [
+    "Do NOT misrepresent driving frequency, license status, garaging address, or household composition.",
+    "Do NOT omit a household member who drives the vehicle — leads to claim denial under undisclosed-driver exclusions.",
+    "Do NOT bind without seeing the quote in writing unless coverage is needed RIGHT NOW (then bind and adjust within the carrier's free-look window).",
+    "Do NOT speculate about a new driver's history if records aren't clear — pull the MVR (motor vehicle record) before the call if possible.",
+    "Do NOT accept a 'we'll figure out the discounts later' — surface them upfront."
+  ],
+  "success_signals": [
+    "Quote provided BEFORE binding.",
+    "Effective date matches the user's preference.",
+    "Lienholder properly added (if applicable).",
+    "Garaging address correctly recorded.",
+    "Eligible discounts surfaced and applied.",
+    "Updated declarations page committed for delivery."
+  ],
+  "failure_signals": [
+    "Rep insists on binding before quoting.",
+    "Rep refuses to break out the premium components.",
+    "Rep refuses to backdate or future-date the effective date.",
+    "Rep cannot add the lienholder.",
+    "Rep proposes a 'driver exclusion' as an alternative — read carefully, this denies coverage for that driver entirely."
+  ],
+  "exit_strategy": {
+    "on_success": "Read back: effective date, new total premium, pro-rated charge, lienholder status, garaging address, declarations-page ETA. Confirm not-yet-bound if reviewing. Email the user a recap immediately.",
+    "on_failure": "Don't bind. Route to `ask_operator` with options: (1) get a competing quote from another carrier before binding, (2) call back at a different time / different rep, (3) escalate to a supervisor or use an independent agent.",
+    "follow_ups": [
+      "Save the updated declarations page when it arrives.",
+      "Send a recap email with the new premium and effective date.",
+      "If a new vehicle, send proof-of-insurance to the lienholder.",
+      "Calendar the next renewal date — rate changes mid-term often re-price at full renewal."
+    ]
+  },
+  "required_user_info": [
+    "Policy number and named-insured info",
+    "Driver: full legal name, DOB, DL number + state, license history",
+    "Vehicle: VIN, year/make/model, financed/leased/owned, lienholder info",
+    "Garaging address",
+    "Desired effective date",
+    "Whether operator authorises binding on this call vs review-then-bind"
+  ],
+  "contributed_by": "insurance-claims agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:09:47Z"
+}

package/dist/skills/built-in/admissions-waitlist-followup.json

@@ -0,0 +1,129 @@
+{
+  "id": "admissions-waitlist-followup",
+  "name": "Admissions Decision Follow-Up — Waitlist Nudge, Deposit Extension",
+  "version": "1.0.0",
+  "category": "other",
+  "tags": [
+    "admissions",
+    "waitlist",
+    "deferred",
+    "deposit",
+    "yield",
+    "phone-call",
+    "education"
+  ],
+  "description": "Call an undergraduate or graduate admissions office to (a) reaffirm interest while on a waitlist, (b) request a deposit-deadline extension while a financial-aid appeal or competing decision is pending, (c) check status of a deferred application, or (d) get specific reviewer feedback to inform a re-application.",
+  "disclaimer": "Admissions officers are people with limited discretion within institutional policy. Some asks (deposit extension, waitlist nudge) are routine; others (admit-now decisions, fee waivers post-deadline, discretionary reconsideration) are rare. Match the ask to the office's actual authority.",
+  "context": {
+    "when_to_use": "User is (a) on a waitlist and the school has either invited Letters of Continued Interest or hasn't moved in 2+ weeks past historical waitlist activation, (b) staring at a deposit deadline that conflicts with another decision still pending, (c) deferred from Early Action / Early Decision and now in the regular-decision pool, or (d) denied and wants to understand why before re-applying.",
+    "preconditions": [
+      "User knows their applicant ID and the exact decision they received.",
+      "User has reviewed the school's published waitlist / yield communications policy — some schools explicitly invite LOCIs, others explicitly say no further contact.",
+      "User has something new to say. A waitlist nudge with no update lands as noise.",
+      "User has competing offers and deadlines mapped, so the extension ask is specific."
+    ],
+    "estimated_call_duration_minutes": 15
+  },
+  "principles": [
+    "Admissions officers remember enthusiasm + specificity. They forget generic 'I really want to attend' emails the second they close the tab.",
+    "The right cadence is one substantive update — not weekly check-ins. Two LOCIs at most: one after waitlist notification, one if you have a real new accomplishment.",
+    "Deposit extensions for a pending aid appeal are routine. Deposit extensions to compare other schools are routine but should be requested politely. Deposit extensions because you 'haven't decided' are softer asks.",
+    "If you say 'I will absolutely attend if admitted from the waitlist', schools take that VERY seriously and may hold you to it. Don't say it unless it's true.",
+    "Reviewer feedback after a denial is sometimes available (especially at law / business / graduate level) and is gold for the next application. Always ask.",
+    "Phone is sometimes better than email — your name gets associated with a person. But never call your way past a 'no further contact' policy."
+  ],
+  "phrases": {
+    "opener_waitlist": "Hi, I'm a waitlisted applicant — applicant ID [ID]. I wanted to confirm you have my updated transcript / new accomplishments on file, and to reaffirm that [school] is my top choice. Could you let me know if there's a way to submit a Letter of Continued Interest or new materials?",
+    "opener_deposit_extension": "Hi, I have a deposit deadline of [date]. I have a financial-aid appeal pending [or: a decision pending from another school I need to compare]. Could I request an extension of [N] days / weeks?",
+    "opener_deferred": "Hi, I was deferred from Early Action / ED. I'd like to check that my file is complete in the regular-decision pool and ask whether you accept updates (mid-year grades, new test scores, new awards).",
+    "opener_post_denial": "Hi, I received a denial decision and I respect that. I'd like to ask whether your office offers reviewer feedback or if there's a specific reason that would help me strengthen a reapplication.",
+    "reaffirm_top_choice": "I want to be clear: [school] is my first choice, and if I'm admitted from the waitlist I will absolutely deposit and attend. I'm saying that because I know schools want to know yield is real.",
+    "what_changed_since": "Since I applied: I [first-author publication / new role / 4.0 last semester / state championship / new portfolio piece]. I think this strengthens my fit because [one sentence].",
+    "ask_for_admissions_officer": "Could I be connected with my regional admissions officer or the reader assigned to my file? I'd like 60 seconds of their time, not the front desk's.",
+    "ask_about_LOCI_policy": "What's your office's policy on Letters of Continued Interest? Is there a preferred format, length, or recipient — and is there a 'no further contact' line I should respect?",
+    "graceful_close_success": "Thank you. To confirm: [extension granted to / LOCI accepted / reviewer feedback scheduled]. May I have your name and email for the record? And is there anything else that would help my file?"
+  },
+  "tactics": [
+    {
+      "name": "Lead with one substantive update, not warm air",
+      "when": "Waitlist LOCI.",
+      "script": "Use `what_changed_since`. The update should be specific (grades, role, publication, award, project). 'Still very interested' is not an update. If there's no new fact, skip the call.",
+      "priority": 1
+    },
+    {
+      "name": "Make the deposit-extension ask concrete",
+      "when": "Requesting more time.",
+      "script": "Use `opener_deposit_extension`. State exact dates, exact reason (aid appeal, competing offer), and exact requested extension. Vague 'a little more time' lands as indecision.",
+      "priority": 2
+    },
+    {
+      "name": "Reaffirm top choice ONLY if true",
+      "when": "Waitlist conversation.",
+      "script": "Use `reaffirm_top_choice`. Schools' yield models are sensitive to this — a clean reaffirmation moves applicants up. But schools also remember; if you take it back, your name is mud at that office and in the region.",
+      "priority": 3
+    },
+    {
+      "name": "Ask for the regional admissions officer",
+      "when": "Front desk is friendly but not the reader.",
+      "script": "Use `ask_for_admissions_officer`. Decisions are made by readers and committees, not by phone-line staff. A 60-second voice memo to a regional officer is more valuable than a 5-minute call with intake.",
+      "priority": 4
+    },
+    {
+      "name": "Ask about LOCI policy explicitly",
+      "when": "Before sending any LOCI.",
+      "script": "Use `ask_about_LOCI_policy`. Some schools (e.g. parts of the Ivy+ set) explicitly invite LOCIs; others mark applications as over-contact if you flood them. Get the rule before you act.",
+      "priority": 5
+    },
+    {
+      "name": "Request reviewer feedback after denial",
+      "when": "Post-denial reapplication is being considered.",
+      "script": "Use `opener_post_denial`. Not all schools offer feedback, but graduate programs (especially MBA, JD, MD, MFA, PhD) sometimes do. Tone: gracious, not aggrieved. The same officer may read the next application."
+    },
+    {
+      "name": "Frame an extension request around what the school cares about",
+      "when": "Pushing for more time.",
+      "script": "Schools care about yield certainty. Frame the extension as 'I want to commit cleanly with my family confident in the finances' rather than 'I'm shopping.' Same ask, very different reception."
+    }
+  ],
+  "boundaries": [
+    "Do NOT promise to attend if admitted unless you mean it — schools track and remember.",
+    "Do NOT flood the office with calls/emails. One substantive contact beats five generic ones.",
+    "Do NOT bypass a stated 'no further contact' policy — it's a screen, and contact past it counts against the applicant.",
+    "Do NOT have a parent call instead of the student for an adult applicant — admissions reads this as a maturity signal.",
+    "Do NOT fabricate new accomplishments for an LOCI. They can be verified and the consequence is rescission."
+  ],
+  "success_signals": [
+    "Admissions officer named and direct email obtained.",
+    "Deposit extension granted in writing.",
+    "LOCI accepted and routed to the reader.",
+    "Mid-year report / new transcript confirmed received.",
+    "Reviewer feedback session scheduled or written feedback offered."
+  ],
+  "failure_signals": [
+    "Office cites 'no further contact' policy explicitly — stop.",
+    "Waitlist is closed and the school has moved to summer melt only.",
+    "Deposit extension denied and no alternative offered.",
+    "Officer is non-committal in a way that signals over-contact (vague answers, deflection to website).",
+    "Reapplication isn't allowed for one year and timing doesn't work."
+  ],
+  "exit_strategy": {
+    "on_success": "Confirm what was agreed (extension date, LOCI submission, feedback meeting). Get name + email. Send a brief thank-you email within 24h reiterating the next concrete step.",
+    "on_failure": "If denied or stalled, note the office's exact words. Plan the alternative: another waitlist, a gap year + reapplication, transfer pathway after a year at another school, or a different program.",
+    "follow_ups": [
+      "Send the LOCI within 24h of the call if invited.",
+      "Email operator the extension date and confirmation source.",
+      "Calendar 2 weeks for follow-up if expected decision hasn't arrived.",
+      "If denied: archive the feedback for the next cycle."
+    ]
+  },
+  "required_user_info": [
+    "Applicant ID + program",
+    "Current decision status (waitlisted, deferred, admitted, denied)",
+    "Deposit deadline (if applicable)",
+    "Competing offers + deadlines (if relevant)",
+    "Specific new updates since application",
+    "School's published LOCI / further-contact policy"
+  ],
+  "contributed_by": "education-admin agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:09:47Z"
+}