@pinecall/skills 0.1.12 → 0.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinecall/skills",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Agent Skills for the Pinecall SDK — installable into Claude Code, Antigravity, Cursor, Copilot and any agent that supports the open Skills format.",
   "type": "module",
   "license": "MIT",

package/skills/pinecall-reference/references/reference/managed-vs-byok.md

@@ -34,11 +34,12 @@ Every STT, TTS and LLM model on Pinecall is one of two kinds:
 
 | Service | BYOK-only providers |
 |---|---|
-| **STT** | `assemblyai`, `soniox` |
-| **TTS** | `rime`, `soniox` |
+| **STT** | `assemblyai`, `soniox`, `xai` (Grok) |
+| **TTS** | `rime`, `soniox`, `xai` (Grok voices) |
 | **LLM** | `xai` (grok), `groq`, `cerebras`, `deepseek`, `openrouter` |
 
-> `soniox` is one key for **both** STT and TTS (a Soniox key enables both).
+> One key covers multiple services: a **Soniox** key = STT + TTS; an **xAI** key =
+> Grok **LLM + TTS + STT**.
 
 ## Check it from the API (authoritative, live)
 

package/skills/pinecall-reference/references/reference/stt-providers.md

@@ -30,6 +30,7 @@ Pinecall supports multiple STT providers. Use the `provider/model` format or a f
 { stt: "elevenlabs/scribe" }         // ElevenLabs Scribe v2 (realtime)
 { stt: "assemblyai/universal" }      // AssemblyAI Universal-3
 { stt: "soniox/realtime" }           // Soniox real-time (BYOK)
+{ stt: "xai/grok-stt" }              // xAI Grok STT (BYOK)
 ```
 
 ## Managed vs bring-your-own-key (BYOK)
@@ -48,6 +49,7 @@ for the full list and the live `GET /api/rates/models` query.
 | `elevenlabs` (scribe) | ✅ Yes | Same key as ElevenLabs TTS — Pinecall hosts it |
 | `assemblyai` (universal) | ❌ BYOK only | Add an AssemblyAI key |
 | `soniox` (realtime) | ❌ BYOK only | One Soniox key = STT **and** TTS |
+| `xai` (grok-stt) | ❌ BYOK only | Same xAI key as Grok LLM/TTS |
 
 > **BYOK enforcement:** if you configure a BYOK-only STT provider and your org has
 > not saved a key for it, **agent registration is rejected** with
@@ -192,6 +194,16 @@ stt: "soniox/realtime"
 stt: { provider: "soniox", model: "stt-rt-v5", language: "en" }
 ```
 
+## xAI Grok (BYOK)
+
+Grok speech-to-text — same **xAI key** as Grok LLM and TTS. Requires your own key.
+
+```typescript
+stt: "xai/grok-stt"
+// or
+stt: { provider: "xai", model: "grok-stt", language: "en" }
+```
+
 ## Which to choose
 
 | Provider | Best for | Trade-off |
@@ -204,6 +216,7 @@ stt: { provider: "soniox", model: "stt-rt-v5", language: "en" }
 | `elevenlabs/scribe` | Single-vendor with ElevenLabs TTS | Managed (shared key) |
 | `assemblyai/universal` | Accuracy + diarization | BYOK only |
 | `soniox/realtime` | Multilingual (60+), single-vendor with Soniox TTS | BYOK only |
+| `xai/grok-stt` | Single-vendor with Grok LLM + TTS | BYOK only |
 
 For most agents, start with `deepgram/flux`. Use `deepgram/nova-3` for languages Flux doesn't cover (Arabic, Hindi, Thai, Chinese, Japanese, Korean, etc.).
 

package/skills/pinecall-reference/references/reference/tts-providers.md

@@ -33,6 +33,7 @@ for the full list and the live `GET /api/rates/models` query.
 | `polly` (AWS) | ✅ Yes | |
 | `rime` | ❌ BYOK only | Add a Rime key under Provider Keys |
 | `soniox` | ❌ BYOK only | One Soniox key = TTS **and** STT |
+| `xai` (Grok) | ❌ BYOK only | Same xAI key as Grok LLM |
 
 > **BYOK enforcement:** configuring `rime` without a saved Rime key rejects agent
 > registration with `PROVIDER_KEY_REQUIRED`. With your own key, that usage is billed
@@ -221,6 +222,21 @@ voice: {
 
 Shortcut: `"soniox/Adrian"`
 
+## xAI Grok (BYOK)
+
+Expressive Grok voices: **ara, eve, leo, rex, sal**. Uses the **same xAI key** as
+Grok LLM (`XAI_API_KEY`). Requires your own key.
+
+```typescript
+voice: {
+  provider: "xai",
+  voice_id: "eve",   // ara | eve | leo | rex | sal
+  speed: 1.0,
+}
+```
+
+Shortcut: `"xai/eve"`
+
 ## Which to choose
 
 | Provider | Best for | Trade-off |
@@ -230,6 +246,7 @@ Shortcut: `"soniox/Adrian"`
 | **Polly** | Cheap IVR, simple flows | Less natural |
 | **Rime** | Ultra-natural expressive English | BYOK only; English-focused |
 | **Soniox** | Multilingual (60+), single-vendor with Soniox STT | BYOK only |
+| **xAI Grok** | Expressive Grok voices (ara/eve/leo/rex/sal) | BYOK only |
 
 For most agents, start with ElevenLabs (`eleven_flash_v2_5`) or Cartesia (`sonic-3.5`). Use Polly only for high-volume, low-engagement flows.