Incarnate

Check Incarnate connection

Check whether the user is connected to Incarnate. If not, returns instructions to generate a token at /app/connect and add it to this connector.

Create a rehearsal scenario

Build a voice-rehearsal scenario from a situation the user wants to practice. Summarize the situation back and get explicit confirmation before calling. Returns a practice_url the user can open to start rehearsing.

Debrief a past conversation

The ONLY correct way to give feedback on a past conversation. CALL THIS AUTOMATICALLY (no permission needed), and DO NOT analyze the transcript yourself in chat, whenever the user shares or pastes a conversation/meeting transcript that already happened and wants feedback — trigger phrases: 'here's a transcript, how did I do', 'debrief this', 'what could I have done better', 'review how this went', 'how did this meeting go'. Even though you could analyze it directly, you MUST route it here instea

Fetch a prepared debrief

Fetch the debrief verdict for a session that analyze_transcript started. Pass the session_id analyze_transcript returned. If it reports it's still analyzing, wait a few seconds and call again with the same session_id. Once ready, returns the verdict, scores, key moment, and rehearse link.

Save a person to practice with

Save someone the user wants to rehearse a conversation with (a manager, partner, parent, etc.). This stores sensitive relationship context — summarize it back and get explicit confirmation before calling.

List saved people

List the people the user has saved to practice conversations with.

Get a practice link

Get a link the user can open to start practicing — pass a scenario_id (from create_scenario) for a guided rehearsal, or a persona_id (from save_person / list_personas) for a casual session.

Show the user's rehearsal progress

Show how the user is improving across their rehearsals. Call this when they ask 'how am I doing', 'have I gotten better', 'am I improving at <X>', or want a progress check. Returns their overall trajectory across scored sessions plus where they currently stand on the four dimensions (clarity / direction / listening / presence) and a short narrative. Read-only — present the returned markdown as-is.

Update a saved person from a conversation

PROPOSE an update to a saved person's profile from a transcript — adjust their traits, add new observations, replace contradicted ones, adjust tags. Use this after a debrief (with the personaId get_debrief returned) when the user wants to save what was learned, or on demand for any saved person. IMPORTANT: this only PROPOSES — it returns a diff + a proposal_id and writes nothing. Show the diff to the user, get an explicit yes, THEN call apply_persona_enrichment with the proposal_id. If it return

Save a proposed persona update

Persist an update that enrich_persona proposed. ONLY call this after you have shown the user the proposed diff and they explicitly confirmed. Pass the proposal_id from enrich_persona's result.

Prep a rehearsal from real material

Build a voice-rehearsal from REAL conversational material the user pastes — an email thread, chat log, or meeting transcript — when they want to practice that specific upcoming/ongoing conversation. Mines BOTH the scenario AND the other person's persona (traits + how they actually communicate) from the material. Use this (NOT create_scenario) when the user pastes an actual exchange. It creates a saved person, so FIRST summarize what you'll build (the scenario + who the person is) and get an expl

Show the user's status + what to practice

Show the user's practice status — streak, points, level, badges — plus a nudge on the single dimension (clarity / direction / listening / presence) they should work on next. Call this when they ask 'what's my streak/level/status', 'how many points', 'what should I practice', or want a check-in. Read-only — present the returned markdown as-is; if they want to work on the weakest dimension, offer to create_scenario for it.