@agenticmail/core 0.9.32 → 0.9.34

package/dist/skills/built-in/dmv-vehicle-registration-renewal.json

@@ -0,0 +1,120 @@
+{
+  "id": "dmv-vehicle-registration-renewal",
+  "name": "DMV: Vehicle Registration Renewal, Address Change, or License Replacement",
+  "version": "1.0.0",
+  "category": "civic",
+  "tags": [
+    "dmv",
+    "vehicle-registration",
+    "drivers-license",
+    "address-change",
+    "phone-call",
+    "state-government",
+    "government-services"
+  ],
+  "description": "Call a state DMV / MVA / BMV / DOL to renew a vehicle registration, change the address on file, or order a replacement driver's license. Most DMVs prefer online self-service — this skill is the fallback when the online flow rejects the user or a hold/flag must be cleared by a human.",
+  "disclaimer": "Not legal advice. DMV procedures vary by state. The agent will not advise on traffic-court strategy, license-suspension appeals, or DUI consequences — those require an attorney or the state's hearing officer.",
+  "context": {
+    "when_to_use": "User cannot complete the task online (system rejects them, a flag/hold appears, an out-of-state transfer is needed, or the renewal window is too tight for mail). Also use when the user has received conflicting information from the website vs. a notice in the mail.",
+    "preconditions": [
+      "User has their driver's-license number OR last 4 of SSN (state-dependent).",
+      "User has the license-plate number and current registration card / VIN if renewing a vehicle.",
+      "User has the new address (with ZIP+4 if known) for an address change.",
+      "User knows whether they need a REAL ID upgrade or a standard renewal.",
+      "User has a callback number — DMV phone lines drop frequently."
+    ],
+    "estimated_call_duration_minutes": 35
+  },
+  "principles": [
+    "DMV hold music is the longest in government. Settle in. Do NOT keep redialing — you lose your place.",
+    "Front-line agents read from a script. If your case is unusual, politely ask for a 'tier 2' or 'supervisor review' — they have lookup tools the front line does not.",
+    "Most DMVs route by ZIP / county. Calling the wrong field office wastes 40 minutes. Confirm you are at the right office before describing the issue.",
+    "Get a confirmation / reference number for ANY change. DMV systems are notoriously slow to propagate and the paper trail saves you later.",
+    "Recognize 'this can only be done in person' early — for many states, license replacement REQUIRES a field-office visit (REAL ID, photo capture). Don't burn 60 minutes on hold to be told to come in."
+  ],
+  "phrases": {
+    "opener_renewal": "Hi, I'm trying to renew the registration on my vehicle. My plate is [PLATE] and my renewal notice says it's due [DATE]. The online portal won't let me complete the renewal — it's giving me [ERROR]. Can you help me figure out what's blocking it?",
+    "opener_address": "Hi, I need to update the address on my driver's license and vehicle registration. The new address is [ADDRESS]. Can we do both in one call?",
+    "opener_replacement": "Hi, I need a replacement driver's license — the original was [lost / stolen / damaged]. Can this be ordered by phone or do I need to come in?",
+    "confirm_right_office": "Just to confirm — am I at the office that handles [county/region]? I want to make sure I'm in the right queue.",
+    "ask_for_hold_reason": "The system says there's a hold or flag on my record. Can you tell me what it is and what office can clear it?",
+    "stall_documents": "Give me one second — I want to pull up the notice in front of me so I read the numbers correctly.",
+    "graceful_close_success": "Thank you. Before we hang up: can I have a confirmation number, your name or agent ID, and the expected date I'll see the change reflected online or receive the document in the mail?",
+    "graceful_close_failure": "I understand. Just so I know my next step — what's the best office, web page, or form for me to use, and is there a way to schedule an in-person appointment from here?"
+  },
+  "tactics": [
+    {
+      "name": "Verify you reached the correct office FIRST",
+      "when": "Within the first 60 seconds of reaching a human.",
+      "script": "Confirm the office handles the user's county/region and the task type. If you're at a call center that only handles licensing and the user needs registration, ask for the right transfer number before describing the full case.",
+      "priority": 1
+    },
+    {
+      "name": "Surface holds and flags before the renewal attempt",
+      "when": "User's online attempt failed with a generic error.",
+      "script": "Ask 'Can you check if there are any holds, flags, or outstanding items on the record?' Common blockers: unpaid toll, emissions/smog requirement, insurance lapse, parking citation, court-ordered suspension. Each routes to a different office.",
+      "priority": 2
+    },
+    {
+      "name": "Bundle related changes",
+      "when": "User needs both license + registration address changes.",
+      "script": "Most states will update both in one call IF you ask explicitly. Front-line reps default to one at a time.",
+      "priority": 3
+    },
+    {
+      "name": "Capture the document path",
+      "when": "Any record change is accepted.",
+      "script": "Ask: 'Will I get an updated card / sticker in the mail, do I need to print something, or is the change electronic-only?' DMV cards in the mail take 2–6 weeks; some states require the user to print a temporary registration.",
+      "priority": 4
+    },
+    {
+      "name": "Escalate to tier 2 / supervisor for unusual cases",
+      "when": "Front-line rep says 'system won't let me' but cannot explain why.",
+      "script": "Politely ask for a supervisor or a 'records specialist'. Many DMV systems have override codes that front-line agents cannot use.",
+      "priority": 5
+    }
+  ],
+  "boundaries": [
+    "Do NOT give legal advice on tickets, suspensions, DUIs, or court-ordered restrictions — refer to an attorney or the issuing court.",
+    "Do NOT share SSN unless the rep has authenticated themselves and the field is necessary for lookup. Last 4 is usually enough.",
+    "Do NOT promise the user the renewal will arrive by a specific date if the rep gave a range — quote the range exactly.",
+    "Do NOT attempt to clear a court-ordered hold by phone — those require the originating court.",
+    "Do NOT claim REAL ID compliance unless the rep confirms it on this transaction."
+  ],
+  "success_signals": [
+    "Rep gives a confirmation / reference number for the change.",
+    "Rep confirms an exact mail-out date or document arrival window.",
+    "Rep clears or identifies a previously unknown hold.",
+    "Rep offers to schedule an in-person appointment if the task can't be done by phone."
+  ],
+  "failure_signals": [
+    "Rep insists the task can only be done in person at a field office (note this is NOT necessarily failure — capture the next step).",
+    "Rep cannot identify why the online portal rejected the user and refuses to escalate.",
+    "Hold time exceeds 60 minutes with no human pickup.",
+    "User has been transferred more than twice and is being routed in a loop."
+  ],
+  "exit_strategy": {
+    "on_success": "Confirm the change, capture the confirmation number, agent name/ID, expected document arrival, and any temporary document (printable receipt, temp registration). Note the next renewal date in the user's calendar.",
+    "on_failure": "Capture the exact next step: which office, which form (DL-XX, REG-XX), in-person required Y/N, appointment URL. Report back to the operator so they can choose between rebooking, in-person visit, or mail-in.",
+    "follow_ups": [
+      "Calendar arrival of the new card/sticker; ping operator if it doesn't show within the quoted window.",
+      "If REAL ID was deferred, add a calendar reminder before the federal deadline.",
+      "If a hold was identified, dispatch a follow-up call to the office that owns the hold (court, tolling authority, insurance carrier)."
+    ]
+  },
+  "required_user_info": [
+    "Driver's license number OR last 4 of SSN",
+    "License plate + VIN (for vehicle tasks)",
+    "Current and new address (with ZIP+4 if available)",
+    "Reason for replacement (lost / stolen / damaged / name change)",
+    "Whether the user wants REAL ID or standard",
+    "Callback number"
+  ],
+  "hang_up_and_call_back_signals": [
+    "You realize you are at the WRONG office (e.g. licensing call center for a registration issue) — politely end and call the correct number.",
+    "You've been on hold > 75 minutes with no movement — try the next morning at opening (call volume drops 30–60% in the first hour).",
+    "Rep is reading from a script that does not match the user's situation and refuses to escalate — hang up, call back, and ask for tier 2 by name."
+  ],
+  "contributed_by": "govt-services-pro agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:09:47Z"
+}

package/dist/skills/built-in/document-call-promises.json

@@ -0,0 +1,145 @@
+{
+  "id": "document-call-promises",
+  "name": "Document the Call So the Next Rep Can't Deny What Was Promised",
+  "version": "1.0.0",
+  "category": "customer-service",
+  "tags": [
+    "documentation",
+    "phone-call",
+    "paper-trail",
+    "promises",
+    "evidence",
+    "follow-up",
+    "customer-support"
+  ],
+  "description": "Build an evidence trail during and immediately after a support call — names, IDs, case numbers, exact wording of commitments, and contemporaneous notes — so a future rep can't say 'no record of that' or 'we never agreed to that'. This skill is foundational; every other escalator skill is multiplied by it.",
+  "disclaimer": "Recording laws vary by state. In one-party-consent states (most of US), you can record without disclosing. In all-party-consent states (CA, FL, IL, MA, MD, NH, PA, WA, etc.), you must inform the rep — and most call-center reps will then say 'we can't be recorded' and hang up, so consider their disclosure 'this call may be recorded' as also covering your end and rely on contemporaneous notes instead. Verify your jurisdiction before recording.",
+  "context": {
+    "when_to_use": "Every customer-service call, but especially: any call where a commitment is made (credit, refund, service restore, callback), any call about an ongoing issue you'll need to reference later, any call after a previous rep made promises you want to lock down.",
+    "preconditions": [
+      "User has note-taking method ready BEFORE the call: paper + pen, text editor, voice memo, or recording app where legal.",
+      "User has a consistent location to store call notes (folder, doc, notes app) — disorganized notes are nearly as bad as no notes.",
+      "User has a few minutes available immediately after the call to consolidate notes while memory is fresh."
+    ],
+    "estimated_call_duration_minutes": 5
+  },
+  "principles": [
+    "Memory degrades fast — names you heard 20 minutes ago feel solid until you go to write them down and realize you have 'Susan or Sarah, S-something'. Capture in REAL TIME, not after.",
+    "What to capture, every call: date + time started, rep name + employee ID, the queue/department, case or ticket number, the exact problem stated, the EXACT WORDING of any commitment ('we will refund $X by [date]' is dramatically different from 'we'll try to refund some of that soon'), and the time the call ended.",
+    "Reps rarely lie outright, but they paraphrase generously. 'We'll see what we can do' becomes 'I was told I'd get a refund' in customer memory. Capturing exact wording protects you from that drift AND protects you from the next rep claiming 'no one would have said that'.",
+    "Decision point — when a rep makes a verbal commitment, STOP and ask them to repeat it. 'I want to make sure I have this right — can you say back exactly what we just agreed to?' Reps often soften the commitment on the readback ('well, we'll try to get the refund processed within 5-7 business days, though it could be longer'). Better to hear the real version now than to discover it next call.",
+    "Get commitments in writing whenever possible. 'Could you email me a summary of what we agreed to?' is a perfectly reasonable ask — and many reps can do it. A written commitment is 10x stronger than a verbal one.",
+    "Case numbers are the universal currency. They survive across reps, queues, and channels. Always ask. Always write down. Always read back. Always reference next time.",
+    "Recording is sometimes legal, sometimes not, often gray. Notes are ALWAYS legal everywhere. Default to thorough notes; recording is a bonus where allowed, not a substitute for notes anywhere."
+  ],
+  "phrases": {
+    "name_id_capture": "Could you spell your first name for me, and what's your employee ID or extension? I'm taking notes so I can credit you if this works out.",
+    "case_number_request": "Have you opened a case or ticket for this? Could you read me the number, and read back the first line of what's noted?",
+    "the_readback_request": "I want to make sure I'm capturing this correctly. Could you read back exactly what we've agreed to, including any specific amounts and dates?",
+    "ask_for_written_confirmation": "Could you email me a summary of what we just agreed to? Even a few lines is fine — I just want to have it in writing for both our records.",
+    "lock_the_commitment": "Just to confirm: [exact restatement of commitment, including amount, action, and date]. Is that accurate?",
+    "promise_to_followup_yourself": "If I don't see [committed action] by [date], may I call back and reference this case number and your name? I want to make sure the path is clear for next time.",
+    "end_of_call_summary": "Before we hang up, let me read back what I have: [name + ID], [department], [case #], [problem], [commitment], [date]. Anything I have wrong?",
+    "after_call_email_template": "Subject: Confirming our call today — case [#]\n\nHi — following up on our phone call today at [time]. To confirm what we agreed:\n\n  • Issue: [one line]\n  • Rep: [name + ID]\n  • Case: [#]\n  • Commitment: [exact words]\n  • Expected by: [date]\n\nPlease reply to confirm this is accurate. If anything is off, let me know so we can correct it. Thanks for your help today."
+  },
+  "tactics": [
+    {
+      "name": "Set up your note-taking before dialing",
+      "when": "Before the call.",
+      "script": "Open a doc or notebook. Pre-fill: date, company, phone number called, the problem in one sentence, what outcome you want. Now you have a scaffold. Don't start a call without one.",
+      "priority": 1
+    },
+    {
+      "name": "Capture name + ID in the first minute",
+      "when": "Right after the rep introduces themselves.",
+      "script": "Use `name_id_capture` if they didn't spell it. Get the ID even if they only volunteered the name. Reps occasionally refuse IDs — note the refusal, that's also data.",
+      "priority": 2,
+      "decision_point": "If the rep refuses to give an employee ID after a polite ask — that's a YELLOW FLAG. Either (a) note it and proceed but be ready to escalate, or (b) immediately ask for a supervisor; refusing identification on a recorded call is unusual."
+    },
+    {
+      "name": "Get a case number opened — explicitly",
+      "when": "Within the first 2-3 minutes once you've stated the issue.",
+      "script": "Use `case_number_request`. If they say 'we don't open a case for this kind of inquiry', push back: 'I'd still appreciate one — even just for my records and follow-up.' Most CRMs let reps open a case in 30 seconds; they just don't volunteer it.",
+      "priority": 3
+    },
+    {
+      "name": "Catch commitments in flight",
+      "when": "Rep says anything that sounds like a promise.",
+      "script": "STOP and use `the_readback_request`. Even 'I'll get that looked into' deserves a clarifying readback: 'When you say looked into — what specifically will happen, by when?' Pin it down while you're both on the line.",
+      "priority": 4,
+      "decision_point": "If the rep softens the commitment on readback (a real refund becomes 'we'll review it'), you now know the real commitment. Don't be upset — be glad you caught the gap before you hung up. Either accept the real version or push for a firmer one."
+    },
+    {
+      "name": "Lock the commitment by repeating it back",
+      "when": "Commitment finalized.",
+      "script": "Use `lock_the_commitment`. Your version, their confirmation. Now it's locked in the recording — if the next rep claims 'no one would have agreed to that', you have the readback to reference.",
+      "priority": 5
+    },
+    {
+      "name": "Ask for written confirmation",
+      "when": "Any non-trivial commitment.",
+      "script": "Use `ask_for_written_confirmation`. Some reps will do it; some can't. Don't fight if they can't — but always ask. A 'yes' is worth more than 30 minutes of negotiation.",
+      "priority": 6
+    },
+    {
+      "name": "End-of-call summary",
+      "when": "Before ending the call.",
+      "script": "Use `end_of_call_summary`. This is the most important sixty seconds of the call. Read back everything you have. Lets you catch errors before you hang up — and signals to the rep that you're documenting.",
+      "priority": 7
+    },
+    {
+      "name": "Send the confirmation email within 1 hour",
+      "when": "Immediately after the call.",
+      "script": "Use `after_call_email_template`. Send to the company's published support address, your own personal address (creates a sent-record), and if you have it, the rep's queue-specific address. Even if the company doesn't reply to confirm, the SEND is your contemporaneous record.",
+      "priority": 8,
+      "decision_point": "If the company replies to the confirmation email contradicting your version of events — you have a problem to flag NOW, not on the day the commitment is supposed to execute. Reply within 24h asking them to reconcile."
+    },
+    {
+      "name": "Store and index the notes",
+      "when": "Same day as the call.",
+      "script": "Move your notes to a single, searchable location with a consistent naming pattern: [Date]_[Company]_[Case#]_[OneLineProblem]. Six months from now, when you need to reference 'that call with Verizon last March', you'll find it in 10 seconds.",
+      "priority": 9
+    }
+  ],
+  "boundaries": [
+    "Do NOT record calls in jurisdictions that require all-party consent without informing the rep — it's illegal AND the recording is inadmissible.",
+    "Do NOT fabricate quotes when reconstructing notes after the fact. Note what you remember in your own words and clearly label any verbatim quotes.",
+    "Do NOT use the notes to publicly shame individual reps. Use them for escalation, regulator complaints, and your own records.",
+    "Do NOT lie about having a recording when you don't ('we have you on tape saying X'). Reps and supervisors will request the recording; you'll be caught.",
+    "Do NOT share confirmation emails or call notes publicly when they contain other parties' employee IDs or personal info.",
+    "Do NOT skip note-taking on 'easy' calls — half the time the easy call turns out to be relevant six weeks later when something goes wrong. Notes are cheap insurance."
+  ],
+  "success_signals": [
+    "Rep voluntarily gives name + ID + case number without being asked.",
+    "Rep agrees to a written summary email.",
+    "Rep's readback of the commitment matches your understanding.",
+    "Confirmation email gets a 'yes, confirmed' reply within 24h.",
+    "Next call: you reference the case number and the new rep pulls up complete notes matching your records."
+  ],
+  "failure_signals": [
+    "Rep refuses to give employee ID.",
+    "Rep refuses to read back the commitment.",
+    "Rep refuses to send a written summary AND claims the company 'doesn't do that' (often false — they do, the rep just doesn't want to).",
+    "Confirmation email is met with silence or auto-reply only.",
+    "Next call: case number doesn't exist in the system, OR exists but notes contradict your version of the commitment."
+  ],
+  "exit_strategy": {
+    "on_success": "File the notes + the confirmation email + any reply in your call-log folder. Set a calendar alert for the commitment date. On that date, verify execution. If executed — close. If not — call back, citing your full documentation.",
+    "on_failure": "If the rep refused to identify themselves OR refused to read back a commitment, treat the call as if NO commitment was made — and either re-engage at a higher tier (`request-supervisor-gracefully`, `bypass-i-am-the-supervisor`) or pivot channels (`multi-channel-escalation`).",
+    "follow_ups": [
+      "On the commitment date: check whether it executed. If yes — close out. If no — call back same day with full documentation.",
+      "If a commitment fails to execute, the documentation becomes the spine of a regulator complaint or executive escalation. Make it count.",
+      "Periodically (quarterly) prune your call-log of resolved issues to keep active files manageable.",
+      "If a company pattern emerges (multiple commitments not honored), the documentation supports a BBB / state-AG complaint of pattern-of-unfulfilled-promises — much stronger than any single case."
+    ]
+  },
+  "required_user_info": [
+    "Note-taking medium ready (doc, paper, notes app)",
+    "Knowledge of recording laws in user's jurisdiction",
+    "User's email address for confirmation",
+    "Account identifier",
+    "A consistent file location / naming convention for storing call records"
+  ],
+  "contributed_by": "support-escalator agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:10:28Z"
+}

package/dist/skills/built-in/early-lease-termination.json

@@ -0,0 +1,126 @@
+{
+  "id": "early-lease-termination",
+  "name": "Negotiate Early Lease Termination Without Penalty",
+  "version": "1.0.1",
+  "category": "real-estate",
+  "tags": [
+    "lease-break",
+    "early-termination",
+    "military",
+    "relocation",
+    "domestic-violence",
+    "habitability",
+    "phone-call",
+    "housing-tenancy"
+  ],
+  "description": "Call the landlord or property manager to negotiate an early lease termination using one of the statutory protections (military SCRA, domestic-violence, habitability) or, where no statute applies, to negotiate a buy-out — while preserving the tenant's legal posture and avoiding a deficiency judgment.",
+  "disclaimer": "Not legal advice. Habitability + early-termination skills are scripted to PRESERVE legal posture (request things in writing, refuse verbal-only assurances) — but the operator must consult a tenant attorney for actual rights determination. Statutory protections vary by jurisdiction.",
+  "context": {
+    "when_to_use": "User needs to break a lease before the end date. Best outcomes come from one of: (a) Servicemembers Civil Relief Act (SCRA) protections for military PCS / deployment, (b) state statutes for domestic violence or stalking, (c) habitability-based constructive eviction after documented failures, (d) job-relocation clauses already in the lease, or (e) negotiated buy-out where no statute applies. Each path has different evidence and notice requirements.",
+    "preconditions": [
+      "User has the lease and has identified any early-termination clauses.",
+      "User has identified which path applies (military, DV, habitability, relocation clause, plain buy-out).",
+      "User has gathered the supporting documentation appropriate to the path (PCS orders, protective order, habitability complaint case number, relocation letter).",
+      "User has a desired move-out date and a realistic flexibility window.",
+      "User understands that landlords can pursue a deficiency judgment for unpaid rent through the lease end date if the lease is broken without a protected path."
+    ],
+    "estimated_call_duration_minutes": 22
+  },
+  "principles": [
+    "Lead with the path, not the apology. If you have an SCRA-qualifying order or a habitability case number, name it early — the conversation shifts immediately.",
+    "Statutory paths are not negotiations — they're notices. The landlord can verify, but cannot legally refuse.",
+    "For non-statutory paths, frame the buy-out as the landlord's best alternative: market re-let cost, vacancy time, and turnover all factor in. A 1–2 month buy-out is often cheaper than a 4-month vacancy + listing fees.",
+    "Mitigation matters. In most jurisdictions, the landlord has a legal DUTY TO MITIGATE — they must try to re-rent the unit rather than just collect rent from the breaking tenant. Mention this if the landlord refuses to re-list.",
+    "Get the termination agreement in writing BEFORE moving out. A signed mutual-release is the document that prevents a deficiency claim from showing up months later.",
+    "NEVER accept a verbal-only release. Move-out without a signed release is the most common path to a surprise judgment 6–12 months later."
+  ],
+  "phrases": {
+    "opener_military": "Hi, I'm a tenant at [unit, address] and I'm calling to give notice under the Servicemembers Civil Relief Act. I've received [PCS / deployment / activation] orders effective [date]. I'll be sending you a copy of the orders and a written notice. The termination is effective 30 days after the next rent due date.",
+    "opener_dv": "Hi, I'm a tenant at [unit, address] and I need to terminate my lease early under [state] domestic-violence / stalking statute. I have [protective order / police report] documenting the qualifying circumstance. I'll send written notice and the supporting documents.",
+    "opener_habitability": "Hi, I'm calling about [unit, address]. Given the [habitability issues — case number / inspector report / repeated failure to repair], I'm exercising my right to terminate due to constructive eviction. I want to discuss how we wrap this up cleanly.",
+    "opener_relocation_clause": "Hi, I'm a tenant at [unit, address]. My lease includes a job-relocation clause — I've received an offer letter from [employer] requiring relocation to [city] by [date]. I'd like to invoke that clause.",
+    "opener_buyout": "Hi, I'm a tenant at [unit, address]. I need to move out before my lease ends, and I want to talk about a fair buy-out — no statute applies, I just need to leave. What does that look like?",
+    "ask_about_re_let_process": "How quickly can you re-list the unit? Your duty to mitigate means you'd be looking for a replacement tenant anyway — I'd rather we treat any month it's re-rented as ending my obligation.",
+    "propose_buyout": "I'm willing to pay [1–2 months] of rent as a clean buy-out, forfeit the deposit if needed, and help market the unit. In exchange I'd want a written mutual release effective [move-out date]. Does that work?",
+    "ask_for_mutual_release": "Before I move anything out, I need a signed mutual release stating that the lease is terminated effective [date], my deposit treatment is [terms], and neither party has further obligations. Can you send that for review?",
+    "decline_holdback": "I can't agree to leave the deposit as an open balance against future charges. The release needs to be final — full and final settlement.",
+    "graceful_close_resolved": "Thank you. To confirm: lease terminates [date], buy-out [amount] paid by [date], mutual release signed before move-out. I'll watch for the document.",
+    "graceful_close_unresolved": "Okay, sounds like we're stuck for today. I'm going to send you written notice and the supporting documentation by certified mail and email — that starts the clock on my end. Let's keep talking."
+  },
+  "tactics": [
+    {
+      "name": "Identify the path and lead with it",
+      "when": "First substantive turn.",
+      "script": "Use the matching opener. The path determines whether this is a notice (SCRA, DV, habitability, relocation clause) or a negotiation (buy-out). Mixing them weakens both.",
+      "priority": 1
+    },
+    {
+      "name": "Send written notice + documentation as the parallel act",
+      "when": "Always, regardless of how the call goes.",
+      "script": "Statutory paths require written notice. Have the operator send certified mail + email with the supporting docs the same day. Without written notice, no statute starts the clock.",
+      "priority": 2
+    },
+    {
+      "name": "Invoke the duty to mitigate",
+      "when": "Landlord threatens to hold you to the full lease term.",
+      "script": "Use `ask_about_re_let_process`. Most jurisdictions require the landlord to try to re-rent — your liability ends when they do (or when they reasonably could have).",
+      "priority": 3
+    },
+    {
+      "name": "Propose a specific, concrete buy-out",
+      "when": "No statute applies and the user just needs out.",
+      "script": "Use `propose_buyout`. Anchor with 1–2 months + deposit. Most landlords accept 2 months because re-letting takes about that long anyway.",
+      "priority": 4
+    },
+    {
+      "name": "Insist on mutual release",
+      "when": "Any termination deal — statutory OR negotiated.",
+      "script": "Use `ask_for_mutual_release`. This is the single document that prevents a 'you still owe us $X' letter from arriving 6 months later. Do NOT move out without it.",
+      "priority": 5
+    },
+    {
+      "name": "Refuse open-ended deposit holdback",
+      "when": "Landlord wants to keep the deposit as 'security against future charges.'",
+      "script": "Use `decline_holdback`. A release that doesn't settle the deposit isn't a release — it's a deferral. Hold for written terms.",
+      "priority": 6
+    }
+  ],
+  "boundaries": [
+    "Do NOT move out before the signed mutual release is in hand if any money is in dispute.",
+    "Do NOT use a statutory path you don't actually qualify for — falsifying SCRA or DV claims is a crime and destroys credibility.",
+    "Do NOT verbally agree to pay a buy-out amount above what the user pre-authorised.",
+    "Do NOT discuss new tenancy plans, new income, or financial position — those reduce sympathy and leverage.",
+    "Do NOT sign a release that contains a non-disparagement clause or a waiver of habitability claims without operator review."
+  ],
+  "success_signals": [
+    "Landlord acknowledges the statutory path and accepts the notice.",
+    "Landlord agrees to a specific buy-out amount and a release date.",
+    "Mutual-release document sent for review in writing.",
+    "Landlord commits to actively re-list and credit any re-rent month."
+  ],
+  "failure_signals": [
+    "Landlord disputes the statutory path even with documentation — escalate to tenant attorney before move-out.",
+    "Landlord demands more than 3 months' rent as a buy-out with no re-let credit.",
+    "Landlord refuses any written release.",
+    "Landlord threatens collections / deficiency judgment without acknowledging duty to mitigate."
+  ],
+  "exit_strategy": {
+    "on_success": "Confirm termination date, payment amount (if any), deposit treatment, and that mutual release will be signed before move-out. Operator emails the recap within 1 hour and sends the written notice + documents same day.",
+    "on_failure": "Send the written notice + documentation by certified mail and email regardless — this starts statutory clocks and creates the record. Consult a tenant attorney before move-out if a deficiency judgment is being threatened.",
+    "follow_ups": [
+      "Send written notice + supporting docs (PCS orders, protective order, habitability case number, relocation letter) by certified mail AND email same day.",
+      "Calendar the statutory effective date.",
+      "Once mutual release is signed, schedule the move-out walkthrough (see `move-out-walkthrough`).",
+      "After move-out, keep the mutual release in a permanent file — it's the document that defeats any future collection attempt."
+    ]
+  },
+  "required_user_info": [
+    "Lease copy and any early-termination clauses",
+    "Path: SCRA (with orders), DV (with order / police report), habitability (with case number), relocation clause, plain buy-out",
+    "Desired move-out date and flexibility window",
+    "Buy-out budget if a negotiated path is needed",
+    "Deposit amount and whether the user is willing to forfeit it as part of the deal"
+  ],
+  "contributed_by": "housing-tenancy agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:09:47Z"
+}

package/dist/skills/built-in/elite-line-escalation.json

@@ -0,0 +1,107 @@
+{
+  "id": "elite-line-escalation",
+  "name": "Airline Elite-Line / Status-Credit Escalation",
+  "version": "1.0.1",
+  "category": "travel",
+  "tags": ["airline", "elite", "status", "phone-line", "concierge", "escalation"],
+  "description": "Route the call to the right tier of phone agent — 1K Voice, ConciergeKey, Diamond, 360, A-List Preferred — and use their wider discretion to unstick a problem the general line can't or won't solve.",
+  "disclaimer": null,
+  "context": {
+    "when_to_use": "User has airline elite status, OR is one tier away from status (status-match candidate), AND needs leverage on a request the general line just denied: change-fee waiver, mile redeposit, OAL rebook, upgrade clearance, fare-class hold, complaint resolution.",
+    "preconditions": [
+      "User has frequent flyer number and current tier confirmed.",
+      "User has PNR if the issue relates to an existing reservation.",
+      "User can articulate the exact ask in one sentence."
+    ],
+    "estimated_call_duration_minutes": 20
+  },
+  "principles": [
+    "Status agents have MORE discretion, not just shorter holds. Front-line CSRs cannot waive fees beyond a small ceiling; elite-line agents have meaningfully higher ceilings.",
+    "Each tier has a published phone tree. Calling the right number is half the battle — wrong number gets you front-line, which has the same script you already failed at.",
+    "Loyalty-loyalty matters. Mention years of status, lifetime miles, recent paid-cabin flying. 'I've been Executive Platinum for 9 years' is leverage; 'I'm Executive Platinum' is just a fact.",
+    "Even non-status callers can be PROMOTED in queue by calling the right ancillary line (Vacations, Reservations Spanish, Reservations Japanese, Group Desk). Hold times are often a fraction of the main line.",
+    "Tone with elite agents: peer-to-peer, not customer-to-rep. They handle thousands of seasoned travelers; sounding like one accelerates the call.",
+    "Status-match agents (the team that processes competitor-status matches) are a parallel escalation path. If your status is about to expire on Carrier A, a match offer from Carrier B is leverage."
+  ],
+  "phrases": {
+    "opener": "Hi — [name], [frequent flyer number], [tier]. I have a quick one: [specific ask in one sentence]. Front-line told me [outcome], but I think this falls in your discretion.",
+    "establish_loyalty": "I've been [tier] for [years] years and flew [N] paid segments with you last year — I'm not trying to game anything, I just want this to work.",
+    "specific_ask": "Specifically I'd like you to [redeposit the miles / waive the change fee / put me on partner X / clear an upgrade / open inventory in Y class / re-issue under a waiver code].",
+    "concede_gracefully": "If the system genuinely won't let you do that, no worries. Could you note the request on my PNR and see if a supervisor or the [HVC desk / liaison desk] can pick it up?",
+    "status_match_pivot": "If we can't get there, I'm thinking about [competitor tier match]. I'd rather stay with you — what can we do?",
+    "graceful_close_success": "Thank you — that's a huge help. Can you confirm the PNR shows [new state], read me the confirmation number, and email me the updated itinerary?",
+    "graceful_close_failure": "Okay, I'll let this one go. Could you note on my account that we tried this and that I'm a long-term flyer? It helps me when I call back."
+  },
+  "tactics": [
+    {
+      "name": "Use the right phone number for your tier",
+      "when": "Before dialling.",
+      "script": "United: 1K Voice (1K only), Premier Platinum line, Global Services has dedicated reps reach out to you. American: ConciergeKey (invite-only top tier, no public number — they call you), Executive Platinum line, Platinum Pro line. Delta: Diamond Medallion line, 360 line (top-tier invite-only). Alaska: MVP Gold 75K line. Southwest: A-List Preferred line. JetBlue: Mosaic line. Numbers are on each program's homepage when logged in.",
+      "priority": 1
+    },
+    {
+      "name": "State the specific ask in ≤15 seconds",
+      "when": "First substantive turn.",
+      "script": "Elite agents reward concision. 'I missed UA 12 LHR-EWR yesterday because of a mechanical, I'd like the miles redeposited and the change fee waived' — that's the whole opener. Save your story for if they need it.",
+      "priority": 2
+    },
+    {
+      "name": "Cite specific tools the agent has",
+      "when": "Agent says 'system won't let me'.",
+      "script": "Examples: 'override desk', 'waiver code', 'unlock fare class with WAIVE remarks', 'fee waiver under loyalty discretion', 'INVOL refund-to-original-FOP'. Knowing the tools by name signals you respect their job and you know what's possible.",
+      "priority": 3
+    },
+    {
+      "name": "Status match as leverage",
+      "when": "Status renewal is in question.",
+      "script": "If you're 5,000 mi shy of re-qualifying for Executive Platinum and you have an open status-match offer from DL Diamond — politely mention it. Agents have soft-discretion miles credits ('soft landing', 'loyalty miles', 'gesture of goodwill') and use them to retain status flyers.",
+      "priority": 4
+    },
+    {
+      "name": "Try ancillary desks for promotion",
+      "when": "Non-status caller, main line wait is >20 minutes.",
+      "script": "AA Vacations desk, UA Vacations, DL Vacations, Reservations Español, AA Australia desk all answer general reservation questions and have shorter queues. Outside-US offices (UA Manila, AA Sydney, DL India) too."
+    },
+    {
+      "name": "Ask for the supervisor only after the agent has tried",
+      "when": "Agent has clearly used their tools and still cannot help.",
+      "script": "'Could you loop in your supervisor? Not because you've done anything wrong, but because the gap is enough that I want to make sure we've checked everything.' This is the negotiate-bill-reduction playbook — works identically here."
+    }
+  ],
+  "boundaries": [
+    "Do NOT call the elite line if you're not at that tier — the agent verifies and the call goes nowhere.",
+    "Do NOT abuse the line for routine seat changes the app handles fine. Burning goodwill costs you on the next real ask.",
+    "Do NOT misrepresent the urgency or facts of the situation.",
+    "Do NOT threaten to switch programs without follow-through; agents have seen this 10,000 times."
+  ],
+  "success_signals": [
+    "Agent picks up in <5 minutes.",
+    "Agent immediately understands the ask without restating.",
+    "Agent applies a waiver code, redeposits miles, or rebooks without arguing.",
+    "Agent thanks you for being a loyal customer (industry tell for 'this is going to work out').",
+    "Agent escalates to a desk above them without prompting."
+  ],
+  "failure_signals": [
+    "Elite line routes you back to general reservations.",
+    "Agent recites the same script the front line used.",
+    "Hold music for 30+ minutes on a top-tier line (rare; usually means IRROPS-driven volume).",
+    "Agent declines and refuses to escalate to supervisor."
+  ],
+  "exit_strategy": {
+    "on_success": "Get the confirmation, email confirmation, agent's first name. Note any soft-landing miles in your tracker.",
+    "on_failure": "Polite goodbye, redial later (different agent often = different result), or write to customer relations / loyalty program team in writing — those teams have additional discretion.",
+    "follow_ups": [
+      "If a waiver was applied, double-check the PNR shows zero-balance and no residual fare difference.",
+      "If miles redeposited, confirm they show in the account within 7 days; if not, call back.",
+      "If status match was floated, follow up in writing with the competitor program now."
+    ]
+  },
+  "required_user_info": [
+    "Frequent flyer number, tier, years at tier",
+    "PNR if applicable",
+    "Specific ask in one sentence",
+    "Outcome from the front-line agent (so the elite agent doesn't repeat)",
+    "Any open status-match or competitor offers"
+  ],
+  "contributed_by": "travel-rebooking agent (v0.9.87 community drop)"
+}