@pinecall/skills 0.1.7 → 0.1.9

package/package.json

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

@@ -21,21 +21,24 @@ Every STT, TTS and LLM model on Pinecall is one of two kinds:
 
 | Service | Managed providers |
 |---|---|
-| **STT** | `deepgram` (flux, nova-3), `gladia`, `transcribe` (AWS) |
+| **STT** | `deepgram` (flux, nova-3), `gladia`, `transcribe` (AWS), `cartesia` (ink-whisper), `elevenlabs` (scribe) |
 | **TTS** | `elevenlabs`, `cartesia` (sonic), `polly` (AWS) |
 | **LLM** | `openai`, `anthropic`, `google` (gemini), `mistral` |
 
+> **One key, both services:** an ElevenLabs (or Cartesia) key serves *both* that
+> vendor's TTS and STT. Pinecall already holds those keys for the managed TTS, so
+> their STT (ElevenLabs **Scribe**, Cartesia **Ink-Whisper**) is **also managed** —
+> no key needed.
+
 ## What requires your own key (BYOK)
 
 | Service | BYOK-only providers |
 |---|---|
-| **STT** | `cartesia` (ink-whisper), `elevenlabs` (scribe), `assemblyai` |
-| **TTS** | `rime` |
+| **STT** | `assemblyai`, `soniox` |
+| **TTS** | `rime`, `soniox` |
 | **LLM** | `xai` (grok), `groq`, `cerebras`, `deepseek`, `openrouter` |
 
-> Note a provider can be **managed for one service and BYOK for another** — e.g.
-> Cartesia **TTS** (sonic) is managed, but Cartesia **STT** (ink-whisper) is BYOK.
-> ElevenLabs **TTS** is managed, ElevenLabs **STT** (scribe) is BYOK.
+> `soniox` is one key for **both** STT and TTS (a Soniox key enables both).
 
 ## Check it from the API (authoritative, live)
 
@@ -55,7 +58,7 @@ curl https://playground.pinecall.io/api/rates/models
     // ...
   ],
   "managedProviders": {
-    "stt": ["deepgram", "gladia", "transcribe"],
+    "stt": ["cartesia", "deepgram", "elevenlabs", "gladia", "transcribe"],
     "tts": ["cartesia", "elevenlabs", "polly"],
     "llm": ["anthropic", "google", "mistral", "openai"]
   }

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

@@ -29,6 +29,7 @@ Pinecall supports multiple STT providers. Use the `provider/model` format or a f
 { stt: "cartesia/ink-whisper" }      // Cartesia Ink-Whisper
 { stt: "elevenlabs/scribe" }         // ElevenLabs Scribe v2 (realtime)
 { stt: "assemblyai/universal" }      // AssemblyAI Universal-3
+{ stt: "soniox/realtime" }           // Soniox real-time (BYOK)
 ```
 
 ## Managed vs bring-your-own-key (BYOK)
@@ -43,9 +44,10 @@ for the full list and the live `GET /api/rates/models` query.
 | `deepgram` (flux/nova) | ✅ Yes | Default, recommended |
 | `gladia` | ✅ Yes | |
 | `transcribe` (AWS) | ✅ Yes | |
-| `cartesia` (ink-whisper) | ❌ BYOK only | Add a Cartesia key |
-| `elevenlabs` (scribe) | ❌ BYOK only | Add an ElevenLabs key |
+| `cartesia` (ink-whisper) | ✅ Yes | Same key as Cartesia TTS — Pinecall hosts it |
+| `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 |
 
 > **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
@@ -135,10 +137,11 @@ stt: {
 }
 ```
 
-## Cartesia Ink-Whisper (BYOK)
+## Cartesia Ink-Whisper
 
-Pairs naturally with Cartesia (Sonic) TTS for a single-vendor voice stack. Requires
-your own Cartesia key.
+Pairs naturally with Cartesia (Sonic) TTS for a single-vendor voice stack.
+**Managed** — the same Cartesia key serves TTS and STT, and Pinecall hosts it (or
+bring your own Cartesia key to bill it directly).
 
 ```typescript
 stt: "cartesia/ink-whisper"
@@ -146,9 +149,10 @@ stt: "cartesia/ink-whisper"
 stt: { provider: "cartesia", model: "ink-whisper", language: "en" }
 ```
 
-## ElevenLabs Scribe (BYOK)
+## ElevenLabs Scribe
 
-Realtime `scribe_v2_realtime`. Uses the same ElevenLabs key as ElevenLabs TTS.
+Realtime `scribe_v2_realtime`. **Managed** — uses the same ElevenLabs key as
+ElevenLabs TTS, which Pinecall hosts (or bring your own ElevenLabs key).
 
 ```typescript
 stt: "elevenlabs/scribe"
@@ -163,8 +167,8 @@ stt: {
 
 ## AssemblyAI (BYOK)
 
-Universal-3 streaming (`u3-rt-pro`) — strong accuracy + diarization. Requires your
-own AssemblyAI key.
+Universal-3 streaming (`u3-rt-pro`) — strong accuracy + diarization. **BYOK only** —
+Pinecall hosts no AssemblyAI key, so add your own under Provider Keys.
 
 ```typescript
 stt: "assemblyai/universal"
@@ -177,6 +181,17 @@ stt: {
 }
 ```
 
+## Soniox (BYOK)
+
+Real-time multilingual STT (60+ languages). One Soniox key serves **both** Soniox
+STT and TTS. Requires your own Soniox key.
+
+```typescript
+stt: "soniox/realtime"
+// or
+stt: { provider: "soniox", model: "stt-rt-v5", language: "en" }
+```
+
 ## Which to choose
 
 | Provider | Best for | Trade-off |
@@ -185,9 +200,10 @@ stt: {
 | `deepgram/nova-3` | Arabic, Hindi, Thai, CJK, and 60+ languages | Slightly higher latency; smart_turn + silero VAD |
 | `gladia/solaria` | Code-switching, multilingual | Higher latency than Deepgram |
 | `transcribe` | AWS-native deployments | AWS pricing model |
-| `cartesia/ink-whisper` | Single-vendor with Cartesia TTS | BYOK only |
-| `elevenlabs/scribe` | Single-vendor with ElevenLabs TTS | BYOK only |
+| `cartesia/ink-whisper` | Single-vendor with Cartesia TTS | Managed (shared key) |
+| `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 |
 
 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

@@ -29,9 +29,10 @@ for the full list and the live `GET /api/rates/models` query.
 | TTS provider | Managed (no key needed) | Notes |
 |---|---|---|
 | `elevenlabs` | ✅ Yes | Default, recommended |
-| `cartesia` (sonic) | ✅ Yes | |
+| `cartesia` (sonic-3.5) | ✅ Yes | |
 | `polly` (AWS) | ✅ Yes | |
 | `rime` | ❌ BYOK only | Add a Rime key under Provider Keys |
+| `soniox` | ❌ BYOK only | One Soniox key = TTS **and** STT |
 
 > **BYOK enforcement:** configuring `rime` without a saved Rime key rejects agent
 > registration with `PROVIDER_KEY_REQUIRED`. With your own key, that usage is billed
@@ -156,7 +157,7 @@ The model is part of the voice config, so it hot-reloads with it — `agent.upda
 voice: {
   provider: "cartesia",
   voice_id: "a0e99841-438c-4a64-b679-ae501e7d6091",
-  model: "sonic-3",
+  model: "sonic-3.5",   // latest; also "sonic-3" / "sonic-latest"
   speed: 1.0,
   volume: 1.0,
   emotion: null,
@@ -168,7 +169,7 @@ Shortcut: `"cartesia/yumiko"`
 
 **Tuning notes:**
 
-- `model: "sonic-3"` — fastest Cartesia model, designed for streaming
+- `model: "sonic-3.5"` — latest/fastest Cartesia model (sub-90ms, 42 languages), designed for streaming. `sonic-3` and `sonic-latest` also available.
 - `emotion` accepts named emotion presets (check Cartesia docs for the current list)
 
 ## AWS Polly
@@ -204,6 +205,22 @@ voice: {
 
 Shortcut: `"rime/cove"`
 
+## Soniox (BYOK)
+
+Real-time TTS in 60+ languages. One Soniox key serves **both** Soniox TTS and STT.
+Requires your own Soniox key.
+
+```typescript
+voice: {
+  provider: "soniox",
+  voice_id: "Adrian",   // Soniox voice name
+  model: "tts-rt-v1",
+  language: "en",
+}
+```
+
+Shortcut: `"soniox/Adrian"`
+
 ## Which to choose
 
 | Provider | Best for | Trade-off |
@@ -212,8 +229,9 @@ Shortcut: `"rime/cove"`
 | **Cartesia** | Real-time streaming, low latency | Smaller voice library |
 | **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 |
 
-For most agents, start with ElevenLabs (`eleven_flash_v2_5`) or Cartesia (`sonic-3`). Use Polly only for high-volume, low-engagement flows.
+For most agents, start with ElevenLabs (`eleven_flash_v2_5`) or Cartesia (`sonic-3.5`). Use Polly only for high-volume, low-engagement flows.
 
 ## Hot-reloading voices