Language Bridge Call

Language Bridge Call

Use this skill when a requester (a property manager, workshop owner, coordinator) needs to coordinate a concrete, non-urgent task with someone who does not speak the requester's language well enough for a phone conversation. The skill places at most two disclosed CALL-E calls: first to the recipient in the recipient's language to deliver the request and capture a structured answer, then (only if that answer is readable) to the requester in the requester's language to relay the answer and pin an agreed outcome.

The value is the pair of calls, not a translation document: many recipients answer the phone but not email, forms, or text in a second language. The result is fail-closed structured JSON, not an agreement made on the agent's own judgment.

This skill does not interpret live conversations, certify anything, or commit either party to contracts, payments, or medical, legal, or financial terms.

When To Use

• Ask for a maintenance access window from a tenant in their language, and report their answer back
• Confirm a schedule change with a seasonal worker or contractor who prefers another language
• Relay one bounded request (an object to bring, a document to have ready, a time to arrive) and capture a yes/no or a counter-proposal
• Produce an evidence-backed, two-sided disposition for a coordinator who would otherwise make phone calls through a friend or a dictionary

When Not To Use

• Medical, legal, financial, emergency, insurance-claim, or government-interaction interpretation
• Anything that needs live back-and-forth between both humans on one line (use a human interpreter)
• Collecting payment details, ID numbers, signatures, or health information
• Calling a number the user did not provide and authorize in the request
• Hidden retries, recurring reminders, surveys, marketing, or political outreach
• Any request where consent from either party is missing or the request is urgent

Required Inputs

• request_id: stable local identifier
• topic: short noun phrase for the call (for example "maintenance access")
• message_to_recipient: what the requester wants conveyed, in plain requester-language sentences
• requester: display_name, role, first_name, phone (E.164, authorized), language, region
• recipient: first_name, phone (E.164, authorized), language, region
• timezone: IANA
• consent: must be true
• authorized_reason: why these two specific numbers may be called for this request

Optional: proposed_windows (max 4 ISO-8601 times with offset the requester can actually honor).

Preflight

1. Confirm the user authorized this one relay (both numbers) for this request.
2. Confirm both phones are E.164 and came from the requester's own records.
3. Refuse if do_not_call is true or consent is not true.
4. Run the dry-run preview and review both goal scripts before any CALL-E plan.

Dry-Run Preview

From the repository root (no CALL-E credentials, no network):

python3 skills/language-bridge-call/scripts/relay_call.py --request skills/language-bridge-call/assets/sample-relay-request.json

Preview validates the request, prints masked phone numbers, both goal scripts, and the exact live command lines. It does not dial.

Fixture mode runs the complete two-call relay state machine against canned CLI envelopes (still no network, no calle install needed):

python3 skills/language-bridge-call/scripts/relay_call.py --request skills/language-bridge-call/assets/sample-relay-request.json --fixture skills/language-bridge-call/scripts/fixtures/relay_happy_path.json
python3 skills/language-bridge-call/scripts/test_relay_call.py

CALL-E Goal Templates

Recipient call, rendered and spoken in recipient.language:

You are an AI phone assistant working for {requester_display_name}, a {requester_role}.
Disclose immediately that you are an AI assistant and that this is one coordination call about {topic}.
Speak {recipient_language} throughout. If the person who answers is not {recipient_first_name}, apologize and end the call.

Purpose: relay this request and capture an answer.
Message: {message_to_recipient}
Offer only these windows, one at a time: {proposed_windows}.

Ask {recipient_first_name} to choose a window, propose a different time, or decline.
Do not discuss payments, contracts, deposits, or legal matters. Do not promise anything.
Close politely once you have captured the answer.

Before closing, record the answer as JSON with exactly these fields: understood (boolean),
consent_given (boolean), wrong_person (boolean), confidence (number between 0 and 1),
choice (one of the offered windows, or an empty string), counter_window (ISO-8601 time with
UTC offset, or an empty string), notes (one short sentence quoting the person, in their language).

Requester call, rendered and spoken in requester.language, includes the recipient's captured answer verbatim:

You are an AI phone assistant calling {requester_first_name} back about {topic}.
Disclose immediately that you are an AI assistant.
Speak {requester_language} throughout.

Relay the recipient's answer exactly: {recipient_answer_summary}
If they chose a window, read it back and ask the requester to accept it.
If they proposed a different time or declined, relay that without negotiation.
Capture accept, decline, or next instruction. Do not commit to anything beyond relaying.

Record the outcome as JSON with exactly these fields: accepted (boolean),
agreed_window (one of the offered windows, or an empty string), notes (one short sentence).