@pinecall/skills 0.1.11 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinecall/skills",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "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

@@ -35,10 +35,11 @@ Every STT, TTS and LLM model on Pinecall is one of two kinds:
 | Service | BYOK-only providers |
 |---|---|
 | **STT** | `assemblyai`, `soniox` |
-| **TTS** | `rime`, `soniox` |
+| **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 + Grok TTS voices.
 
 ## Check it from the API (authoritative, live)
 
@@ -107,6 +108,20 @@ key for 'xai' — add your key under Provider Keys in the dashboard, then reconn
 
 Pinecall never silently falls back to its own key for a BYOK provider.
 
+## Plan limits & model allow-list
+
+Two more gates are enforced at agent registration, both rejecting with
+`MODEL_NOT_ALLOWED`:
+
+1. **Must be a priced model in the DB.** Any STT/TTS/LLM model you declare must exist
+   in the rate table (be a known, priced model) — unknown models are rejected.
+2. **Must be allowed on your plan.** Plans can restrict which models a tier may use.
+   For example, the **free tier can use ElevenLabs flash + multilingual, but not the
+   pricier models** (and Cartesia/Polly in full). Paid plans allow everything priced.
+
+Use the access check above (`fetchModelAccess` / `GET /api/models/access`) to see the
+verdict and `reason` (`plan_restricted`, `unknown_model`, …) before connecting.
+
 ## Add your own key
 
 - **Dashboard** → **Provider Keys** → pick the provider, paste the key.

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.