voice-call · diff
git:20260218.a87179d to git:20260310.9d58126
30 added, 21 removed. Audit A to A.
---
name: voice-call
- description: Start voice calls via the Cybara voice-call plugin.
- metadata: {"cybara":{"emoji":"📞","skillKey":"voice-call","requires":{"config":["plugins.entries.voice-call.enabled"]}}}
+ description: Start and manage agent-driven voice calls on macOS through the `voice_call` tool.
+ metadata: {"cybara":{"emoji":"📞","skillKey":"voice-call"}}
---
# Voice Call
- Use the voice-call plugin to start or inspect calls (Twilio, Telnyx, Plivo, or mock).
+ Use `voice_call` when an agent needs to place or manage a phone call.
- ## CLI
+ ## Backends
- ```bash
- cybara voicecall call --to "+15555550123" --message "Hello from Cybara"
- cybara voicecall status --call-id <id>
- ```
+ - `mode: "macos"` or `mode: "auto"` on macOS:
+ Starts a FaceTime phone call and can play spoken prompts through the local system voice.
+ - `mode: "mock"`:
+ Dry-run backend for tests, demos, and local verification without starting a real call.
## Tool
- Use `voice_call` for agent-initiated calls.
+ Use `voice_call` for agent-initiated call flows.
Actions:
- - `initiate_call` (message, to?, mode?)
- - `continue_call` (callId, message)
- - `speak_to_user` (callId, message)
- - `end_call` (callId)
- - `get_status` (callId)
+ - `check_support`
+ - `initiate_call`
+ - `continue_call`
+ - `speak_to_user`
+ - `end_call`
+ - `get_status`
- Notes:
- - Requires the voice-call plugin to be enabled.
- - Plugin config lives under `plugins.entries.voice-call.config`.
- - Twilio config: `provider: "twilio"` + `twilio.accountSid/authToken` + `fromNumber`.
- - Telnyx config: `provider: "telnyx"` + `telnyx.apiKey/connectionId` + `fromNumber`.
- - Plivo config: `provider: "plivo"` + `plivo.authId/authToken` + `fromNumber`.
- - Dev fallback: `provider: "mock"` (no network).
+ Useful arguments:
+ - `to` or `phone`
+ - `callId`
+ - `message`
+ - `mode`
+ - `voice`
+ - `rate`
+
+ ## Notes
+
+ - macOS mode is local-device call assistance, not a managed carrier/VoIP session.
+ - `initiate_call` starts the FaceTime call.
+ - `speak_to_user` / `continue_call` use the macOS `say` voice on the local machine.
+ - `end_call` closes FaceTime to end the active call.
+ - Use `mode: "mock"` when you need an agent workflow or test without placing a live call.