@pinecall/skills 0.1.12 → 0.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pinecall/skills",
3
- "version": "0.1.12",
3
+ "version": "0.1.13",
4
4
  "description": "Agent Skills for the Pinecall SDK — installable into Claude Code, Antigravity, Cursor, Copilot and any agent that supports the open Skills format.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -35,10 +35,11 @@ Every STT, TTS and LLM model on Pinecall is one of two kinds:
35
35
  | Service | BYOK-only providers |
36
36
  |---|---|
37
37
  | **STT** | `assemblyai`, `soniox` |
38
- | **TTS** | `rime`, `soniox` |
38
+ | **TTS** | `rime`, `soniox`, `xai` (Grok voices) |
39
39
  | **LLM** | `xai` (grok), `groq`, `cerebras`, `deepseek`, `openrouter` |
40
40
 
41
- > `soniox` is one key for **both** STT and TTS (a Soniox key enables both).
41
+ > One key covers multiple services: a **Soniox** key = STT + TTS; an **xAI** key =
42
+ > Grok LLM + Grok TTS voices.
42
43
 
43
44
  ## Check it from the API (authoritative, live)
44
45
 
@@ -33,6 +33,7 @@ for the full list and the live `GET /api/rates/models` query.
33
33
  | `polly` (AWS) | ✅ Yes | |
34
34
  | `rime` | ❌ BYOK only | Add a Rime key under Provider Keys |
35
35
  | `soniox` | ❌ BYOK only | One Soniox key = TTS **and** STT |
36
+ | `xai` (Grok) | ❌ BYOK only | Same xAI key as Grok LLM |
36
37
 
37
38
  > **BYOK enforcement:** configuring `rime` without a saved Rime key rejects agent
38
39
  > registration with `PROVIDER_KEY_REQUIRED`. With your own key, that usage is billed
@@ -221,6 +222,21 @@ voice: {
221
222
 
222
223
  Shortcut: `"soniox/Adrian"`
223
224
 
225
+ ## xAI Grok (BYOK)
226
+
227
+ Expressive Grok voices: **ara, eve, leo, rex, sal**. Uses the **same xAI key** as
228
+ Grok LLM (`XAI_API_KEY`). Requires your own key.
229
+
230
+ ```typescript
231
+ voice: {
232
+ provider: "xai",
233
+ voice_id: "eve", // ara | eve | leo | rex | sal
234
+ speed: 1.0,
235
+ }
236
+ ```
237
+
238
+ Shortcut: `"xai/eve"`
239
+
224
240
  ## Which to choose
225
241
 
226
242
  | Provider | Best for | Trade-off |
@@ -230,6 +246,7 @@ Shortcut: `"soniox/Adrian"`
230
246
  | **Polly** | Cheap IVR, simple flows | Less natural |
231
247
  | **Rime** | Ultra-natural expressive English | BYOK only; English-focused |
232
248
  | **Soniox** | Multilingual (60+), single-vendor with Soniox STT | BYOK only |
249
+ | **xAI Grok** | Expressive Grok voices (ara/eve/leo/rex/sal) | BYOK only |
233
250
 
234
251
  For most agents, start with ElevenLabs (`eleven_flash_v2_5`) or Cartesia (`sonic-3.5`). Use Polly only for high-volume, low-engagement flows.
235
252