@pinecall/skills 0.1.14 → 0.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinecall/skills",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "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/stt-providers.md

@@ -33,6 +33,44 @@ Pinecall supports multiple STT providers. Use the `provider/model` format or a f
 { stt: "xai/grok-stt" }              // xAI Grok STT (BYOK)
 ```
 
+## Using an STT in an agent
+
+`stt` goes on the agent config (or per phone number / per call). Use a `provider/model`
+shortcut, or the full config object documented per provider below — both forms are
+interchangeable anywhere `stt` is accepted.
+
+```typescript
+import { Pinecall } from "@pinecall/sdk";
+
+const pc = new Pinecall(); // reads PINECALL_API_KEY
+
+// Shortcut form
+const agent = pc.agent("support", {
+  stt: "deepgram/flux",
+  voice: "elevenlabs/sarah",
+  llm: "openai/gpt-5-chat-latest",
+  prompt: "You are a friendly support agent.",
+});
+
+// Full config object form (same field, with tuning)
+pc.agent("support", {
+  stt: { provider: "deepgram", model: "nova-3", language: "en", smart_format: true, keyterms: ["Pinecall"] },
+  voice: "elevenlabs/sarah",
+  llm: "openai/gpt-5-chat-latest",
+  prompt: "...",
+});
+```
+
+Per-number and per-call overrides use the same `stt` value:
+
+```typescript
+agent.addPhoneNumber("+14155551234", { stt: "deepgram/flux", language: "en" });
+call.update({ stt: "deepgram/nova-3" });   // mid-call swap
+```
+
+> Turn detection & VAD are **auto-derived** from the STT provider — never set
+> `turnDetection`/`vad` manually. Each provider section below lists its full config.
+
 ## Managed vs bring-your-own-key (BYOK)
 
 Some providers work out of the box on Pinecall's managed keys; the newer ones
@@ -98,7 +136,7 @@ Or with tuning:
 ```typescript
 stt: {
   provider: "deepgram",
-  model: "nova-3",
+  model: "nova-3",            // "nova-3" | "nova-2"
   language: "en",
   interim_results: true,
   smart_format: true,
@@ -106,7 +144,9 @@ stt: {
   profanity_filter: false,
   endpointing_ms: 300,
   utterance_end_ms: 1000,
-  keywords: ["pinecall"],
+  keywords: ["pinecall"],      // nova-2 keyword boosting
+  keyterms: ["pinecall"],      // nova-3 keyterm prompting
+  min_confidence: 0.0,         // drop transcripts below this confidence (0 = off)
 }
 ```
 

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

@@ -179,8 +179,11 @@ Shortcut: `"cartesia/yumiko"`
 voice: {
   provider: "polly",
   voice_id: "Joanna",
-  engine: "neural",
+  engine: "neural",        // "neural" | "standard"
   language: "en-US",
+  rate: "medium",          // "slow" | "medium" | "fast" | "+10%" / "-10%"
+  volume: "medium",        // "soft" | "medium" | "loud" | "+6dB" / "-6dB"
+  pitch: "+5%",            // standard engine only
 }
 ```
 
@@ -189,6 +192,7 @@ Shortcut: `"polly/joanna"`
 **Tuning notes:**
 
 - `engine: "neural"` is required for natural-sounding output. The older `standard` engine is robotic.
+- `rate` / `volume` accept named levels or relative values; `pitch` only applies to the `standard` engine.
 - Polly is the cheapest option but the least natural — fine for IVR-style flows, not for engaging conversation.
 
 ## Rime (BYOK)