Pine Voice

Make real phone calls via Pine AI's voice agent. The agent calls the specified number, navigates IVR systems, handles verification, conducts negotiations, and returns a full transcript.

Authentication

Credentials persist in

~/.pine-voice/credentials.json

Before making calls, check if already authenticated:

node {baseDir}/scripts/auth-check.mjs

If

authenticated

true

false

Step 1: Request verification code

node {baseDir}/scripts/auth-request.mjs "user@example.com"

Returns

{"request_token": "...", "email": "..."}

request_token

Tell the user: "A verification code has been sent to your email. Check your inbox (and spam) and give me the code."

Step 2: Verify and save credentials

node {baseDir}/scripts/auth-verify.mjs "user@example.com" "REQUEST_TOKEN" "CODE"

Returns

{"status": "authenticated", "credentials_path": "..."}

When to use

Use this skill when the user wants you to make a phone call on their behalf.

Important: The voice agent can only speak English. Supported countries: US/CA/PR (+1), UK (+44), AU (+61), NZ (+64), SG (+65), IE (+353), HK (+852).

Best for

• Calling customer service to negotiate bills, request credits, or resolve issues
• Scheduling meetings or appointments by phone
• Making restaurant reservations
• Calling businesses to inquire about services or availability
• Following up with contacts on behalf of the user

How to make a call

Step 1: Gather all required information

Before calling, you must collect every piece of information the callee might need. The voice agent cannot ask a human for missing information during the call. Anticipate what will be required: authentication details, payment info, negotiation targets, relevant context.

Step 2: Initiate the call

Pass call parameters as JSON via stdin:

node {baseDir}/scripts/call.mjs <<'EOF'
{
  "dialed_number": "+14155551234",
  "callee_name": "Comcast Customer Service",
  "callee_context": "Cable and internet provider. Account holder: Jane Doe, account #12345.",
  "call_objective": "Negotiate monthly bill down to $50/mo. Do not accept above $65/mo.",
  "detailed_instructions": "Mention 10-year customer loyalty. If no reduction, ask for retention department.",
  "caller": "negotiator",
  "voice": "female",
  "max_duration_minutes": 60,
  "enable_summary": false
}
EOF

Returns

{"call_id": "..."}

Step 3: Poll for results

Poll every 30 seconds until

is_terminal

true

node {baseDir}/scripts/call-status.mjs "CALL_ID"

When complete, the response includes

transcript

duration_seconds

credits_charged

is_terminal

IMPORTANT: Use

sessions_spawn

Example task for sessions_spawn:

Make a phone call using the Pine Voice scripts. Run: node {baseDir}/scripts/call.mjs with stdin JSON: {"dialed_number": "+14155551234", "callee_name": "The Restaurant", "callee_context": "Italian restaurant, making a dinner reservation", "call_objective": "Reserve a table for 4 at 7pm tonight", "caller": "communicator"}. Then poll with: node {baseDir}/scripts/call-status.mjs "CALL_ID" every 30 seconds until is_terminal is true. Report the full transcript and outcome.

Step 4: Evaluate the transcript

Do NOT rely on the

status

Treat the call as a FAILURE if:

• Only Pine's agent speaks and the other side is silent
• The other party's responses are automated/recorded (voicemail, IVR-only)
• Extended silence from both sides
• The callee hung up before the objective was discussed

Call parameters

dialed_number

+14155551234

callee_name

callee_context

call_objective

detailed_instructions

caller

"negotiator"

"communicator"

voice

"male"

"female"

"female"

max_duration_minutes

enable_summary

true

false

false

Negotiation calls

For negotiations, set

caller

"negotiator"

• Target outcome: "Reduce monthly bill to $50/mo"
• Acceptable range: "Will accept up to $65/mo"
• Hard constraints: "Do not change plan tier"
• Leverage points: "10-year customer, competitor offers $45/mo"
• Fallback: "Request one-time credit of $100"
• Walk-away: "Ask for retention department"

Examples

Test call: "Call my phone at +1XXXXXXXXXX. Tell me that Pine Voice is set up and working."

Restaurant reservation: "Call +14155559876 and make a reservation for 4 tonight at 7pm. If unavailable, try 7:30 or 8pm. Name: Jane Doe."

Model requirements

Pine Voice works best with models that have thinking/reasoning capabilities.

• Recommended: Claude Sonnet/Opus 4.5+, GPT-5.2+, Gemini 3 Pro
• Not recommended: Gemini 3 Flash, or models without thinking capabilities

Privacy

Pine Voice processes call data on Pine AI's servers. Credentials are stored locally in

~/.pine-voice/credentials.json