@agenticmail/core 0.9.32 → 0.9.33

package/dist/skills/built-in/medical-records-transfer.json

@@ -0,0 +1,138 @@
+{
+  "id": "medical-records-transfer",
+  "name": "Request Medical Records or Chart Transfer Between Providers",
+  "version": "1.0.0",
+  "category": "medical-admin",
+  "tags": [
+    "medical-records",
+    "hipaa",
+    "release-of-information",
+    "chart-transfer",
+    "phone-call",
+    "healthcare"
+  ],
+  "description": "Call a healthcare provider's medical records / ROI (Release of Information) department to request the operator's chart be sent to themselves, to a new provider, to a specialist, or to a legal/administrative recipient — within HIPAA timelines and without paying inflated copy fees.",
+  "disclaimer": "Not medical advice. Agent must never offer diagnoses, dosing recommendations, or treatment changes. Surface those decisions to the operator via ask_operator.",
+  "context": {
+    "when_to_use": "Operator is switching providers, seeing a specialist who needs prior records, applying for disability/insurance/legal use, or just wants a personal copy. The friction is real but the law is on the operator's side: under HIPAA, patients have a right to their records within 30 days (sometimes extendable to 60).",
+    "preconditions": [
+      "Operator's name (current and any prior names on the chart), DOB (read-only).",
+      "Approximate date range of care at the source provider.",
+      "Exact name of the source provider/clinic/hospital and address/fax/portal of their medical-records department.",
+      "Exact destination: another provider (with name, fax/portal, NPI), the operator themselves (email/portal/mailing address), or a third party (with operator's explicit authorization).",
+      "Scope: full chart, specific date range, specific record types (labs, imaging, notes, immunizations), or specific encounters.",
+      "Whether operator has already signed and submitted a Release of Information form — they almost always need to."
+    ],
+    "estimated_call_duration_minutes": 12
+  },
+  "principles": [
+    "Under HIPAA, providers must respond to a patient records request within 30 days (one 30-day extension allowed with written notice). Knowing this turns 'we'll get to it' into 'I'd like to note the request date for the 30-day clock'.",
+    "Records-direct-to-another-provider is usually free; records-to-the-patient sometimes has a per-page fee. Have the records go provider-to-provider when the destination is another doctor.",
+    "Electronic format is your right. Under HIPAA's right-of-access rule and the 21st Century Cures Act, you can request records electronically in the format the provider keeps them (PDF, CCDA, etc.). Don't accept 'we only mail paper' as a final answer for an EMR-based practice.",
+    "The ROI department is separate from the front desk. If front desk says they can't help, that doesn't mean ROI can't.",
+    "Records can be lost in transit (fax misroute, portal mismatch, wrong NPI). Always verify with the DESTINATION provider that they actually received and ingested the chart — 'sent' is not 'received'."
+  ],
+  "phrases": {
+    "opener": "Hi, I'm calling on behalf of [Operator]. We need to request a copy of their medical records / chart transfer. Could you get me to your Medical Records or Release of Information department?",
+    "state_request": "We need [scope: full chart / date range / record type] for [Operator], DOB [as provided], from approximately [year range]. The destination is [recipient].",
+    "ask_about_roi_form": "What's the Release of Information form process? Is it digital through the portal, or do you need a signed PDF? Once it's signed, where does it go?",
+    "request_electronic_format": "We'd like the records delivered electronically — PDF or CCDA preferred. Can you send them through [destination portal / secure email / direct messaging]?",
+    "invoke_hipaa_clock": "I want to note today's date as the request submission so we have the HIPAA 30-day timeline on record. Could you give me a tracking or request number?",
+    "ask_about_fees": "What fees, if any, apply? For provider-to-provider transfer, fees are usually waived — can you confirm?",
+    "ask_about_special_records": "Are mental-health notes, substance-use treatment notes, HIV results, or genetic information held separately? Those sometimes need additional authorization — what's the process?",
+    "destination_verify": "Just to confirm the destination: that's [Recipient Name], at [fax / portal / address / NPI]. Once you send, how will I know it went out?",
+    "stall_research": "One moment — let me pull up the destination provider's contact info.",
+    "verify_readback": "So: records request for [Operator] from [source provider] to [destination], scope [X], format [electronic], submission date [today], request number [Y], fee [$Z or waived], expected delivery within [N] days. Did I get that right?",
+    "graceful_close": "Thank you. I'll follow up with the destination provider in [N] days to confirm receipt. Have a good day."
+  },
+  "tactics": [
+    {
+      "name": "Get to ROI, not the front desk",
+      "when": "First substantive turn.",
+      "script": "Use `opener`. The front desk often deflects with 'fill out a form'; the ROI team knows the actual process. Don't get stuck at the wrong queue.",
+      "priority": 1
+    },
+    {
+      "name": "Be specific about scope to avoid delay",
+      "when": "Describing what records you need.",
+      "script": "Use `state_request`. 'Full chart' takes longer to process than 'visit notes + labs from 2022-2024'. If operator only needs a slice, ask for the slice.",
+      "priority": 2
+    },
+    {
+      "name": "Request electronic format explicitly",
+      "when": "ROI starts describing process.",
+      "script": "Use `request_electronic_format`. Under federal rules, the operator has a right to electronic delivery if the provider keeps records electronically. Paper-by-mail is slow and lossy.",
+      "priority": 3
+    },
+    {
+      "name": "Start the HIPAA clock with a timestamp + request number",
+      "when": "Before ending the call.",
+      "script": "Use `invoke_hipaa_clock`. Get a request number and submission date on record. If the 30-day window lapses, this is the evidence used to escalate.",
+      "priority": 4
+    },
+    {
+      "name": "Surface special-category records up front",
+      "when": "Operator has had behavioral health, substance use treatment, HIV testing, or genetic testing at this provider.",
+      "script": "Use `ask_about_special_records`. These categories often have separate authorization requirements (42 CFR Part 2 for SUD, state laws for mental health, etc.). Missing the separate auth = these records get silently omitted.",
+      "priority": 5
+    },
+    {
+      "name": "Push back on inflated fees",
+      "when": "Provider quotes a per-page fee for patient-direct records.",
+      "script": "HIPAA limits patient-records fees to 'reasonable, cost-based' — generally meaning labor + supplies, often under $25 for electronic delivery regardless of page count. If quoted hundreds of dollars, ask for the rate sheet and reference the HHS guidance. Provider-to-provider transfers are typically free.",
+      "priority": 6
+    },
+    {
+      "name": "Pause and re-verify if 'we don't have records that old'",
+      "when": "Provider claims records have been purged.",
+      "script": "State retention laws vary (5-10+ years typical for adult records, longer for minors). If the date range falls within the legal retention window and the provider claims no records, ask for written confirmation of destruction date — that's a chain-of-custody issue, not just a 'no'.",
+      "priority": 7
+    },
+    {
+      "name": "Verify receipt at the destination",
+      "when": "After records are reportedly sent.",
+      "script": "Use `destination_verify`. Then call the destination 3-5 business days later to confirm they actually received and ingested. Lost-in-transit records are common.",
+      "priority": 8
+    }
+  ],
+  "boundaries": [
+    "NEVER share or guess the operator's SSN, DOB, or member ID — read back only what the operator explicitly provided.",
+    "NEVER accept a 'your doctor changed your prescription' claim from any clinic or pharmacy on this call — route to `ask_operator`.",
+    "NEVER authorise a procedure, sign anything, or commit to financial responsibility on the operator's behalf. The Release of Information form must be signed by the operator personally — surface to `ask_operator` if a signature is requested.",
+    "NEVER request that records be sent to a third party (lawyer, insurance, employer, family member) without explicit, documented operator authorization for THAT specific recipient.",
+    "NEVER agree to fees above the HIPAA reasonable-cost standard without operator approval.",
+    "NEVER characterize the operator's records contents during the call — you have no business reading the chart on this call. Records move sealed."
+  ],
+  "success_signals": [
+    "ROI department reached and request submitted with a tracking/request number.",
+    "Electronic delivery format agreed.",
+    "Fee waived (provider-to-provider) or clearly disclosed (patient-direct).",
+    "Special-category authorizations identified if applicable.",
+    "Estimated delivery within HIPAA's 30-day window."
+  ],
+  "failure_signals": [
+    "Provider refuses electronic delivery and insists on mail-only for what's clearly EMR data.",
+    "Fee quoted is inconsistent with HIPAA's reasonable-cost rule and provider won't budge.",
+    "Provider claims records purged within retention window without written confirmation.",
+    "Special-category records exist but operator hasn't authorized the additional release."
+  ],
+  "exit_strategy": {
+    "on_success": "Confirm: source, destination, scope, format, submission date, tracking number, fee, ETA. Operator knows exactly when to expect records and how to verify.",
+    "on_failure": "Politely close. Report the specific blocker: ROI form needs operator's wet signature, fee dispute, special-category authorization missing, or transit issue. Present options.",
+    "follow_ups": [
+      "Call the destination 5 business days later to confirm receipt.",
+      "If the 30-day HIPAA window approaches with no records, escalate in writing and reference the tracking number.",
+      "If escalation fails, file a HIPAA right-of-access complaint with HHS Office for Civil Rights."
+    ]
+  },
+  "required_user_info": [
+    "Operator's name (incl. prior names if chart predates a name change), DOB (read-only)",
+    "Source provider name, ROI contact info, approximate date range of care",
+    "Destination: name, fax/portal/address/NPI",
+    "Scope: full chart / date range / record types",
+    "Whether ROI form has been signed and submitted",
+    "Whether special-category records (mental health, SUD, HIV, genetic) are in scope and authorized"
+  ],
+  "contributed_by": "healthcare-navigator agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:09:47Z"
+}

package/dist/skills/built-in/medical-withdrawal.json

@@ -0,0 +1,131 @@
+{
+  "id": "medical-withdrawal",
+  "name": "Withdrawal, Incomplete, or Medical Withdrawal",
+  "version": "1.0.0",
+  "category": "other",
+  "tags": [
+    "withdrawal",
+    "incomplete",
+    "medical-withdrawal",
+    "dean",
+    "leave",
+    "phone-call",
+    "education"
+  ],
+  "description": "Call the dean of students, academic advising, or student-affairs office to choose between a course withdrawal (W), an incomplete grade (I), or a medical withdrawal — and to navigate the documentation, financial-aid, and re-entry consequences of each.",
+  "disclaimer": "Each option carries different consequences for the transcript, financial aid (including Return to Title IV calculations), tuition refund, health insurance, on-campus housing, and immigration status (F-1/J-1). This skill helps navigate the process; it does not substitute for medical, legal, or financial advice.",
+  "context": {
+    "when_to_use": "The user can't finish the current term as planned because of (a) a medical or mental-health issue with documentation, (b) a family emergency, (c) overload that's now untenable, or (d) a single course they could finish later if granted an Incomplete. Use BEFORE finals if at all possible — past finals, the options collapse to retroactive medical withdrawal which is harder and slower.",
+    "preconditions": [
+      "User can describe what's happening in one sentence and roughly when it started.",
+      "User has access to a clinician or counselor who can document the condition with dates (campus health, primary care, therapist, ER discharge).",
+      "User has at least a vague sense of which courses to keep, drop, or finish-later.",
+      "User has checked the academic calendar for the last-day-to-withdraw and last-day-to-receive-an-Incomplete deadlines."
+    ],
+    "estimated_call_duration_minutes": 30
+  },
+  "principles": [
+    "The three options are different tools, not synonyms: W (course-by-course, GPA-neutral, transcript visible), I (course finishes next term, instructor-dependent), MW (full-term, often refundable, requires documentation, can affect aid + housing + immigration).",
+    "Incompletes are an INSTRUCTOR'S decision, not the registrar's. The dean can't grant one — only the professor can. Always start with the instructor for an Incomplete.",
+    "Medical withdrawal is a benefit, not a punishment. The transcript notation is usually 'W' or 'MW', not 'F'. The cost is usually the term, not the GPA.",
+    "Re-entry after a medical withdrawal often requires a clearance letter from a provider AND a meeting with the dean of students. Plan for that on the front end.",
+    "Federal financial aid: dropping below half-time triggers the loan grace-period clock. Withdrawing past 60% of the term avoids Return to Title IV recalculation. Get the date.",
+    "International students on F-1/J-1 status: a withdrawal can terminate SEVIS unless authorized by the DSO. Loop the international-student office BEFORE filing."
+  ],
+  "phrases": {
+    "opener": "Hi, I need to step back from this term — at least one course, possibly all of them — for medical reasons. I'd like to talk through what my options are: withdrawal, incomplete, or medical withdrawal. Can we walk through them?",
+    "ask_for_dean_of_students": "Could I speak with the dean of students or an associate dean? I'd like to make sure I get the right option, not just the easiest paperwork.",
+    "ask_for_60_percent_date": "What date does the term hit 60% completion? I want to understand the Return to Title IV implications of withdrawing before vs. after that point.",
+    "ask_about_incomplete": "For [course], could I request an Incomplete instead? I've talked to the instructor and they're [open / not open] to it. What does your office need to formalize that?",
+    "ask_about_MW_documentation": "What documentation do you require for a medical withdrawal? Does the provider need to be on-campus, or is an outside clinician acceptable? Is a letter sufficient or do you need records?",
+    "ask_about_re_entry": "If I take a medical withdrawal, what is the process to come back? Do I need a clearance letter, a return interview, a re-application?",
+    "ask_about_housing_meal": "I'm in [housing / on a meal plan]. If I withdraw, what happens — refund, prorated, terminated immediately?",
+    "ask_about_F1_status": "I'm on F-1 status. Has the international-student office been looped in on this conversation? I don't want to file before talking to my DSO.",
+    "graceful_close_success": "To confirm: I'm filing [form] by [date], with [documentation], and the effective date will be [date]. Tuition refund will be [%], financial-aid recalculation will be [status], housing termination is [date], and re-entry requires [steps]. May I have your name and email for follow-up?"
+  },
+  "tactics": [
+    {
+      "name": "Map the three options before choosing",
+      "when": "Beginning of the call.",
+      "script": "Use the `opener`. Force the conversation through all three options before deciding — W, I, MW. Front-line staff sometimes default-recommend whichever is easiest paperwork, not which is best for the student.",
+      "priority": 1
+    },
+    {
+      "name": "Talk to the instructor BEFORE the dean for an Incomplete",
+      "when": "User can plausibly finish one or two courses by submitting a paper / final at a later date.",
+      "script": "Use `ask_about_incomplete`. The instructor must agree and usually sets the completion deadline (often 6 weeks to one term). Without that yes, the dean can't act.",
+      "priority": 2
+    },
+    {
+      "name": "Get the 60% date and the refund schedule",
+      "when": "Considering a withdrawal of any kind.",
+      "script": "Use `ask_for_60_percent_date`. Schools must perform a Return to Title IV calculation for withdrawals before 60% of the term — this can result in the student owing back unearned aid. After 60%, no recalculation.",
+      "priority": 3
+    },
+    {
+      "name": "Loop the DSO for international students",
+      "when": "User is F-1 or J-1 status.",
+      "script": "Use `ask_about_F1_status`. A withdrawal that's not authorized by the DSO can terminate SEVIS within days — that's a much bigger problem than the term. The DSO can authorize an Authorized Early Withdrawal that protects status.",
+      "priority": 4
+    },
+    {
+      "name": "Frontload the documentation",
+      "when": "Pursuing medical withdrawal.",
+      "script": "Use `ask_about_MW_documentation`. A short provider letter with: condition (in general terms), dates of impact, prognosis, recommendation to withdraw. HIPAA-protected detail is not required and not advised — keep it terse.",
+      "priority": 5
+    },
+    {
+      "name": "Pre-arrange re-entry conditions",
+      "when": "Planning to return next term or next year.",
+      "script": "Use `ask_about_re_entry`. Get the exact requirements (clearance letter, meeting with dean, re-application) in writing now — students who return 6 months later often find requirements have shifted.",
+      "priority": 6
+    },
+    {
+      "name": "Escalate to the dean of students if blocked",
+      "when": "Front-line advising says the only option is W when documentation supports MW.",
+      "script": "Use `ask_for_dean_of_students`. The dean of students can authorize medical withdrawal, refund-schedule exceptions, and housing extensions that registrars and bursars cannot."
+    }
+  ],
+  "boundaries": [
+    "Do NOT submit medical documentation that isn't real. Schools verify clinicians and falsifying medical records is a serious violation.",
+    "Do NOT withdraw before the DSO has authorized it if the user is on F-1 / J-1.",
+    "Do NOT take an Incomplete without a written completion plan (deadline + remaining work + how grade is calculated) from the instructor.",
+    "Do NOT promise a return date — medical recovery isn't a calendar.",
+    "Do NOT skip the financial-aid call. The bursar will recover overpayment whether the student knew or not."
+  ],
+  "success_signals": [
+    "Dean of students agrees the case fits medical withdrawal.",
+    "Instructor confirms Incomplete in writing with a completion deadline.",
+    "Return to Title IV calculation is favorable (after 60% of the term, or aid impact is small).",
+    "DSO has been consulted and is preparing authorized withdrawal paperwork.",
+    "Housing / meal-plan refunds are pro-rated to the withdrawal date."
+  ],
+  "failure_signals": [
+    "Past the medical-withdrawal deadline for this term and retroactive process requires an academic-standing committee review (weeks).",
+    "Instructor refuses Incomplete and student is too unwell to finish.",
+    "Withdrawal drops F-1 student below course-load minimum without DSO authorization — SEVIS termination is imminent.",
+    "Financial-aid recalculation results in significant repayment owed.",
+    "Housing is on academic-year contract with no medical exception clause."
+  ],
+  "exit_strategy": {
+    "on_success": "Confirm chosen option, effective date, documentation due date, financial-aid impact, housing/meal-plan status, DSO authorization status (if applicable), and re-entry conditions. Get the dean's email.",
+    "on_failure": "Identify the specific blocker. If documentation: who else can provide it. If timing: is retroactive withdrawal possible. If aid: can the school offer institutional grants to bridge the recalculation. Escalate to dean of students if not yet involved.",
+    "follow_ups": [
+      "Email the operator a written summary of the chosen path, deadlines, and contacts.",
+      "Calendar the re-entry checkpoints (clearance letter, return interview) 30 days before target return.",
+      "If Incomplete: calendar the instructor's completion deadline minus 1 week as a working buffer.",
+      "If medical withdrawal: schedule a check-in with the dean of students 2 weeks before re-enrollment to confirm requirements haven't changed."
+    ]
+  },
+  "required_user_info": [
+    "Student ID and current course load",
+    "One-sentence description of the issue + approximate start date",
+    "Provider name + contact (with permission to verify dates)",
+    "Immigration status (F-1, J-1, citizen, permanent resident)",
+    "Housing / meal-plan / health-insurance status",
+    "Financial aid composition (Pell, Stafford, Parent PLUS, institutional grant, scholarships, work-study)",
+    "Target return term"
+  ],
+  "contributed_by": "education-admin agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:09:47Z"
+}

package/dist/skills/built-in/mid-call-evidence-collection.json

@@ -0,0 +1,159 @@
+{
+  "id": "mid-call-evidence-collection",
+  "name": "Mid-Call Evidence Collection — Names, Refs, Times, Exact Wordings",
+  "version": "1.0.1",
+  "category": "other",
+  "tags": [
+    "meta-skill",
+    "evidence",
+    "phone-call",
+    "documentation",
+    "audit-trail",
+    "critical-reasoning"
+  ],
+  "description": "Every call should leave a paper trail. Collect rep name, confirmation/reference numbers, exact wordings of any commitment, timestamp, and ideally a written follow-up — all while staying conversational and not turning the call into an interrogation. Evidence is the lifeline for every downstream escalation.",
+  "disclaimer": null,
+  "context": {
+    "when_to_use": "Every call. Especially any call involving: money, contract changes, claim decisions, policy interpretations, commitments to do something later, promises of credit, escalations.",
+    "preconditions": [
+      "Agent is keeping a structured log alongside the call (rep name, time, key statements).",
+      "Agent has a clear post-call report template the user can read."
+    ],
+    "estimated_call_duration_minutes": 5
+  },
+  "principles": [
+    "Without evidence, the call didn't happen. Memory degrades; documentation does not.",
+    "Collect evidence WITHOUT signalling that you are collecting evidence. Curiosity and politeness, not surveillance.",
+    "Three pieces of evidence are non-negotiable: (1) rep's first name (or ID), (2) date/time of call, (3) any reference/case/confirmation number created.",
+    "For commitments, get the EXACT WORDING. 'You'll waive the fee' is not the same as 'a one-time courtesy waiver of $35 on the November statement'. Specificity is the evidence.",
+    "Ask for written confirmation by default. Email, in-account message, or text. Verbal is worth less than written, and written from the rep is worth more than written from the user.",
+    "When the rep says they 'can't' provide a confirmation number — ask what the alternative trace is. There's always an internal ticket ID, an interaction ID, or a transfer log.",
+    "Don't push evidence collection past the point of damaging the relationship. A friendly call with imperfect documentation beats a hostile call with perfect documentation."
+  ],
+  "phrases": {
+    "initial_name_capture": "Sorry, I missed your name when we started — could you say it again? I want to make sure I credit you properly in my notes.",
+    "ref_number_request": "Could I get a confirmation number or reference for this conversation? Just for my records.",
+    "exact_wording_playback": "Let me make sure I have this exactly right: you said [paraphrase]. Did I get that wording right, or do you want to adjust it?",
+    "written_follow_up_request": "Could you send me an email or in-account note summarising what we just agreed? Even a one-liner is helpful.",
+    "soft_timestamp": "Just to anchor my notes — what time are you showing on your end?",
+    "ask_alternative_trace": "Okay, no confirmation number for this one — is there an interaction ID, ticket number, or note ID I can reference instead?",
+    "transfer_handoff_note": "Before you transfer me, could you note on the account the discussion we just had — and give me the reference for that note?"
+  },
+  "tactics": [
+    {
+      "name": "Capture the rep's name early and naturally",
+      "when": "Within the first minute, ideally after the rep introduces themselves.",
+      "script": "Use `initial_name_capture` if you missed it; otherwise just acknowledge ('Thanks, [name]'). Use the name a few times in conversation — both warmer AND solidifies your memory of it.",
+      "priority": 1
+    },
+    {
+      "name": "Log call start time and rep ID",
+      "when": "Pre-call or at first hello.",
+      "script": "Record system time. If rep volunteers an ID number, log that too. If not, names + timestamps usually triangulate well enough.",
+      "priority": 2
+    },
+    {
+      "name": "Playback any commitment in their language",
+      "when": "Rep agrees to do anything specific.",
+      "script": "Use `exact_wording_playback`. The act of playing back creates the auditable utterance — and forces the rep to confirm or revise. Both outcomes are good for you.",
+      "priority": 3
+    },
+    {
+      "name": "Demand a confirmation/reference number",
+      "when": "Any account change, credit, transfer, or policy decision.",
+      "script": "Use `ref_number_request`. Don't accept 'we'll just have a record of it' — push for a number you can quote.",
+      "priority": 4
+    },
+    {
+      "name": "Get written follow-up",
+      "when": "Any material commitment.",
+      "script": "Use `written_follow_up_request`. Even a one-line email is gold. Note whether it arrives — if it doesn't within 24-48 hours, that itself is evidence."
+    },
+    {
+      "name": "Mark transfers with an account note",
+      "when": "Being transferred to a different rep / team.",
+      "script": "Use `transfer_handoff_note`. Otherwise, mid-transfer context evaporates and you re-explain from zero — usually with weaker leverage."
+    },
+    {
+      "name": "Fall back to alternative trace IDs",
+      "when": "Rep refuses or can't provide a confirmation number.",
+      "script": "Use `ask_alternative_trace`. Every modern CRM creates SOME identifier per interaction. The rep's tool has it."
+    }
+  ],
+  "alternative_interpretations": [
+    {
+      "observation": "Rep says 'we don't give out confirmation numbers for that'.",
+      "consider": [
+        "Genuinely true for trivial interactions (general questions).",
+        "False; every CRM logs interactions, rep just doesn't want to provide.",
+        "Means the change wasn't actually made — there's nothing to confirm.",
+        "Rep doesn't know how to find the ID in their tool.",
+        "Different team handles confirmations and rep isn't authorised."
+      ],
+      "next_action": "Use `ask_alternative_trace`. If still nothing, ask: 'Then how will I prove this conversation happened if I need to reference it later?' The honest answer reveals whether the commitment is real."
+    },
+    {
+      "observation": "Rep gives a vague commitment ('we'll take care of it').",
+      "consider": [
+        "Friendly closer, real action will happen.",
+        "Friendly closer, no action will happen because nothing was actually filed.",
+        "Real action, but in 3-10 business days and the rep is bad at expectation-setting.",
+        "Filed under a different account or different fee than expected."
+      ],
+      "next_action": "Use `exact_wording_playback` to force specificity: what exactly, by when, against which line item, with which ID."
+    },
+    {
+      "observation": "Rep promises a callback / follow-up.",
+      "consider": [
+        "Will happen at the named time.",
+        "Will happen, but later than promised.",
+        "Will not happen — promise was a closer.",
+        "Will happen from a different rep with no context."
+      ],
+      "next_action": "Ask: 'If the callback doesn't happen by [time], what's the best number for me to call to find you or someone with context?' Locks in a fallback plan."
+    },
+    {
+      "observation": "You notice you're not logging anything — call is conversational and flowing.",
+      "consider": [
+        "Good rapport, weak documentation. The rapport is fine; the documentation is not.",
+        "You're being deliberately disarmed by a skilled rep.",
+        "Nothing material has happened yet — logging will matter later.",
+        "Your attention is being managed away from things you should ask about."
+      ],
+      "next_action": "Pause internally. Re-engage the log. Take the next opportunity to capture name, time, and the key claim made so far."
+    }
+  ],
+  "boundaries": [
+    "Do NOT record the call covertly. Two-party-consent jurisdictions require disclosure; even one-party jurisdictions have ethical norms.",
+    "Do NOT make up confirmation numbers if a rep refuses to provide them — note 'rep refused to provide' instead.",
+    "Do NOT badger the rep for ID — most companies don't require last names from reps for safety reasons.",
+    "Do NOT use evidence collection as a threat ('I'm writing this down') — that escalates without benefit."
+  ],
+  "success_signals": [
+    "Rep proactively provides a confirmation/reference number.",
+    "Written follow-up arrives during or shortly after the call.",
+    "Rep names a specific date, amount, and account for any commitment.",
+    "Transfers come with a noted handoff and a traceable interaction ID."
+  ],
+  "failure_signals": [
+    "Rep refuses or evades all forms of evidence (no name, no ref, no written follow-up).",
+    "Commitments stay vague no matter how many times you replay them.",
+    "Written follow-up never arrives despite promise.",
+    "Account notes vanish between calls (next rep says 'I don't see anything')."
+  ],
+  "exit_strategy": {
+    "on_success": "Compile the call log: rep name(s), times, ref numbers, exact commitments, written follow-up status, and any open items. Share with user.",
+    "on_failure": "Document the evasion itself — that IS evidence. Note exact refusal wording, time, and rep name (if obtained). User has grounds for written escalation citing failure to document.",
+    "follow_ups": [
+      "Check whether promised written follow-up arrives within 24-48 hours; if not, callback citing the prior conversation by ref number.",
+      "Calendar any future-dated commitments (credit on next bill, callback date) for verification."
+    ]
+  },
+  "required_user_info": [
+    "Account number / login so confirmations can be tied to record.",
+    "Email and/or phone for written follow-up to be sent to.",
+    "Authority for the agent to request written follow-up by default."
+  ],
+  "contributed_by": "critical-reasoning agent (v0.9.87 community drop)",
+  "updated_at": "2026-05-20T06:09:47Z"
+}

package/dist/skills/built-in/mirror-technique.json

@@ -0,0 +1,145 @@
+{
+  "id": "mirror-technique",
+  "name": "The Mirror: Repeat to Unlock",
+  "version": "1.0.0",
+  "category": "negotiation",
+  "tags": ["voss", "mirroring", "isopraxism", "stalling", "phone-call", "real-time"],
+  "description": "Repeat the last 1-3 words (or a critical phrase) of what the counterparty just said, with upward inflection. Triggers them to elaborate, exposes constraints, and buys you thinking time without disrupting flow.",
+  "disclaimer": "Mirroring overused sounds parrot-like and condescending. 3-4 mirrors per 30-minute call is normal; 10+ is a tic. Vary with labels and calibrated questions.",
+  "context": {
+    "when_to_use": "When you want the counterparty to keep talking — to surface constraints, expand on policy, justify a number, or reveal a hidden lever. Especially useful in the first 10 minutes when you're building a map of what's negotiable.",
+    "preconditions": [
+      "Voice channel (mirrors via email work but are much weaker — they read as snark).",
+      "Counterparty has just said something containing a number, policy, jargon term, or hesitation marker.",
+      "You can deliver the mirror with curious upward inflection — same words but as a question."
+    ],
+    "estimated_call_duration_minutes": 15
+  },
+  "principles": [
+    "A mirror is the last 1 to 3 words of what they said, repeated as a question. Not paraphrased. Verbatim. The verbatim repetition is what triggers the elaboration instinct.",
+    "Pair every mirror with silence (4-6 seconds). The mirror is the question; the silence is the rest of the question.",
+    "Pick the words that carry the constraint. If they say 'we can't go below $200 for new accounts', mirror 'new accounts?' — that's where the flex lives.",
+    "Mirroring buys you time. While they elaborate, you're free to think about what to ask next or to consult your notes.",
+    "Mirrors are non-confrontational. You're not arguing; you're inviting more detail. The counterparty rarely notices the move.",
+    "When in doubt between a label and a mirror: use a label for emotion, a mirror for information."
+  ],
+  "phrases": {
+    "policy_mirror": "[Rep: 'It's a 30-day return policy.'] → 'A 30-day return policy?'",
+    "number_mirror": "[Rep: 'The list price is $4,200.'] → '$4,200?'",
+    "jargon_mirror": "[Rep: 'That account is on a legacy tier.'] → 'A legacy tier?'",
+    "qualifier_mirror": "[Rep: 'We don't usually do that mid-cycle.'] → 'Usually?'",
+    "hesitation_mirror": "[Rep: 'I don't think I can…'] → 'You don't think you can?'",
+    "constraint_mirror": "[Rep: 'For new accounts only.'] → 'New accounts only?'",
+    "mirror_followup_silence": "[Just stay quiet for 4-6 seconds — do not soften the mirror.]"
+  },
+  "tactics": [
+    {
+      "name": "Mirror the constraint word",
+      "when": "Rep states a rule, policy, or limit with a qualifying word (only, usually, typically, currently, for now).",
+      "script": "Repeat the qualifying word back as a question. 'Usually?' / 'For now?' / 'Currently?' — qualifiers signal the rule has exceptions; the mirror invites the exception out.",
+      "priority": 1
+    },
+    {
+      "name": "Mirror the jargon",
+      "when": "Rep uses internal terminology ('legacy account', 'grandfathered rate', 'override code', 'CC promo').",
+      "script": "Mirror the jargon as a question. The rep will explain — and the explanation will tell you about adjacent tiers and override paths you didn't know existed.",
+      "priority": 2
+    },
+    {
+      "name": "Mirror the number",
+      "when": "Rep delivers a price, fee, or limit number.",
+      "script": "Mirror the number with upward inflection. Forces the rep to either justify it or move it.",
+      "priority": 3
+    },
+    {
+      "name": "Mirror the hesitation",
+      "when": "Rep uses softening verbs: 'I think', 'I believe', 'I might be able to', 'probably'.",
+      "script": "Mirror the hedge. 'You think?' / 'Might be able to?' — converts a soft maybe into either a firm yes or a firm no, which is more actionable than soft maybe.",
+      "priority": 4
+    },
+    {
+      "name": "Mirror to stall",
+      "when": "You need 5-10 seconds to think and don't want a verbal 'um' or 'let me think'.",
+      "script": "Mirror the last few words of what the rep said. The rep will spend 20-30 seconds elaborating, giving you cover.",
+      "priority": 5
+    }
+  ],
+  "decision_tree": {
+    "description": "Mirrors must be deployed within ~2 seconds of the counterparty finishing their sentence — any longer and the moment is gone. Listen for the trigger word; when you hear it, mirror immediately.",
+    "branches": [
+      {
+        "if_you_hear": "A qualifying word: 'usually', 'typically', 'for now', 'currently', 'normally', 'in most cases'.",
+        "interpretation": "There IS an exception. The qualifier is the door.",
+        "say": "Mirror the qualifier alone: 'Usually?' / 'For now?'",
+        "do_not": "Do not say 'so there are exceptions?' — too direct. The mirror does the same work without confrontation."
+      },
+      {
+        "if_you_hear": "A specific number — price, fee, term length, limit.",
+        "interpretation": "Numbers spoken aloud often have flex the rep is mentally bracketing.",
+        "say": "Mirror the number with upward inflection: '$200?' / '12 months?'",
+        "do_not": "Do not add 'is that flexible?' — the mirror already asks that."
+      },
+      {
+        "if_you_hear": "Internal jargon you don't know the meaning of.",
+        "interpretation": "Hidden product/policy layer. Probably has tiers you haven't explored.",
+        "say": "Mirror the jargon: 'A legacy tier?' / 'Override code?'",
+        "do_not": "Do not pretend to know what it means. The mirror is a free education that doesn't reveal ignorance."
+      },
+      {
+        "if_you_hear": "Soft modal verbs: 'I think', 'I believe', 'might', 'probably', 'maybe'.",
+        "interpretation": "The rep is uncertain. There's space to move.",
+        "say": "Mirror the hedge: 'You think?' / 'Might be able to?'",
+        "do_not": "Do not call out the uncertainty directly ('you don't sound sure'). Mirror is friendlier."
+      },
+      {
+        "if_you_hear": "An emotionally charged statement ('that's just how it is', 'I'm being honest with you').",
+        "interpretation": "Emotional, not informational. Mirror is the WRONG tool.",
+        "say": "Use a label from `01-tactical-empathy-labeling` instead.",
+        "do_not": "Do not mirror emotion — it reads as mockery."
+      },
+      {
+        "if_you_hear": "A flat 'no' with no surrounding qualifying language.",
+        "interpretation": "Not enough material to mirror. Need a different tool.",
+        "say": "Use a calibrated question from `02-calibrated-questions`: 'What about it doesn't work for you?'",
+        "do_not": "Do not mirror 'no?' — it's combative."
+      },
+      {
+        "if_you_hear": "A long rambling explanation.",
+        "interpretation": "Rep is overexplaining; they're not sure of their position OR they're stalling.",
+        "say": "Mirror the SINGLE most consequential phrase from the ramble: the one with the constraint.",
+        "do_not": "Do not mirror the whole sentence. Pick 1-3 words."
+      },
+      {
+        "if_you_hear": "Silence after your mirror.",
+        "interpretation": "Mirror is working — they're constructing the elaboration.",
+        "say": "Nothing. Wait 6-8 seconds.",
+        "do_not": "Do not rescue. The mirror's power comes from forcing them to fill the air."
+      }
+    ]
+  },
+  "boundaries": [
+    "Do NOT mirror more than 4 times in a single 30-minute call — diminishing returns and reads as parrot.",
+    "Do NOT mirror emotional outbursts — label them instead.",
+    "Do NOT mirror sarcastically — tone must be genuinely curious.",
+    "Do NOT mirror your own previous mirror (loops happen — break with a label or calibrated question)."
+  ],
+  "success_signals": [
+    "Rep elaborates on the mirrored word for 20+ seconds, revealing nuance.",
+    "Rep softens the qualifier ('well, usually — but I could see making an exception if…').",
+    "Rep explains the jargon AND volunteers an adjacent tier you didn't know existed.",
+    "Number you mirrored gets moved by the rep without you asking."
+  ],
+  "failure_signals": [
+    "Rep responds 'yes, that's what I said' — your mirror was clumsy or too obvious. Pivot to label.",
+    "Rep gets annoyed — you've mirrored too often or with wrong tone.",
+    "Mirror produces only a one-word confirmation, not elaboration — try a calibrated question instead."
+  ],
+  "exit_strategy": {
+    "on_success": "Once the mirror surfaces the exception/flex, immediately use it: 'Got it — and how do I get access to that legacy tier?'",
+    "on_failure": "If mirrors aren't producing elaboration, the rep may be too disengaged or too scripted. Switch tools: try `01-tactical-empathy-labeling` to break the script."
+  },
+  "required_user_info": [
+    "None directly — this is a real-time technique. But knowing the user's goal helps pick WHICH word to mirror."
+  ],
+  "contributed_by": "negotiation-master agent (v0.9.87 community drop)"
+}