@pinecall/skills 0.1.1 → 0.1.2

package/build.mjs

@@ -33,7 +33,9 @@ const HOUSE_RULES = `## House rules — always apply
 - **TTS model is auto-derived from \`language\`** — non-English agents (e.g.
   \`language: "es"\`) default ElevenLabs to \`eleven_multilingual_v2\` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on \`eleven_flash_v2_5\`. Override with \`voice: { ..., model: "..." }\`.
+  English stays on \`eleven_flash_v2_5\`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level \`flash: true\` flag. To pin any model,
+  use \`voice: { ..., model: "..." }\` (explicit model always wins over \`flash\`).
 - **Greeting**: inbound → \`greeting\` field in \`pc.agent()\`; outbound → \`greeting\`
   field in \`agent.dial()\`. It is sugar for \`call.say()\` in \`call.started\`.
 - **Auth**: \`new Pinecall()\` reads \`PINECALL_API_KEY\` from env and auto-connects.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinecall/skills",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "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-agent-skills/SKILL.md

@@ -30,7 +30,9 @@ table below indexes every page; open the `references/…` file for the full text
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-concepts/SKILL.md

@@ -34,7 +34,9 @@ table below indexes every page; open the `references/…` file for the full text
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-examples/SKILL.md

@@ -52,7 +52,9 @@ const agent = pc.agent("mara", {
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-guides/SKILL.md

@@ -61,7 +61,9 @@ const agent = pc.agent("mara", {
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-quickstart/SKILL.md

@@ -47,7 +47,9 @@ const agent = pc.agent("mara", {
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-reference/SKILL.md

@@ -36,7 +36,9 @@ table below indexes every page; open the `references/…` file for the full text
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

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

@@ -77,9 +77,46 @@ The server picks the ElevenLabs model from your `language`:
 | `en` (or unset) | `eleven_flash_v2_5` | Fastest, optimized for real-time streaming |
 | Any non-English (`es`, `fr`, `de`, …) | `eleven_multilingual_v2` | Flash/Turbo don't normalize text, so Spanish & other languages mispronounce numbers, dates, currency and abbreviations. The multilingual model reads them naturally. |
 
-> `eleven_multilingual_v2` is billed at a higher rate than flash (it's a higher-quality model). If you'd rather keep the faster/cheaper flash model for a non-English agent, pin it explicitly (see below).
+> `eleven_multilingual_v2` is billed at a higher rate than flash (it's a higher-quality model). If you'd rather keep the faster/cheaper flash model for a non-English agent, use the `flash` shortcut or pin the model explicitly (both below).
 
-**Override the model** with the optional `model` field — it always wins over the auto-default:
+#### `flash: true` — keep flash on a non-English agent
+
+The multilingual model trades a little **latency** for much better pronunciation.
+If your non-English agent should prioritize **lowest latency / lowest cost** over
+pronunciation quality, set the top-level `flash` flag — it opts out of the
+multilingual auto-default and keeps `eleven_flash_v2_5`:
+
+```typescript
+const agent = pc.agent("sofia", {
+  prompt: "Sos Sofía, asistente de la clínica.",
+  llm: "openai/gpt-5-chat-latest",
+  voice: "elevenlabs/agus",
+  stt: "deepgram/flux",
+  language: "es",
+  flash: true,        // ← stay on eleven_flash_v2_5 despite language: "es"
+});
+```
+
+`flash` is a sibling of `language` (not inside `voice`), so it reads cleanly with
+the rest of the shortcuts. Semantics:
+
+| Config | Resulting ElevenLabs model |
+|---|---|
+| `language: "es"` | `eleven_multilingual_v2` (auto) |
+| `language: "es"`, `flash: true` | `eleven_flash_v2_5` |
+| `language: "en"` (with or without `flash`) | `eleven_flash_v2_5` |
+| `voice: { model: "..." }` (any `flash`/`language`) | the pinned model — explicit always wins |
+
+Notes:
+
+- **ElevenLabs only.** `flash` has no effect on Cartesia or Polly.
+- **No-op for English** — English already defaults to flash.
+- **An explicit `voice: { model }` always wins** over `flash`. Use `flash: true`
+  for the common "I want the cheap fast model" case; use the `model` field when
+  you need a specific model id.
+- Works per-channel too: `phoneNumbers: [{ number, language: "es", flash: true }]`.
+
+**Override the model** with the optional `model` field — it always wins over both the auto-default and `flash`:
 
 ```typescript
 voice: {

package/skills/pinecall-sdk-api/SKILL.md

@@ -49,7 +49,9 @@ const agent = pc.agent("mara", {
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-sdk-api/references/api/agent.md

@@ -35,7 +35,8 @@ const agent = pc.agent("my-agent", {
 | Config field | Type | Description |
 |---|---|---|
 | `voice` | `string \| VoiceConfig` | TTS provider — shortcut or full config |
-| `language` | `string` | BCP-47 language code |
+| `language` | `string` | BCP-47 language code. Non-English auto-selects ElevenLabs `eleven_multilingual_v2` |
+| `flash` | `boolean` | Keep ElevenLabs `eleven_flash_v2_5` on a non-English agent (lowest latency/cost) instead of the multilingual auto-default. ElevenLabs-only; see [TTS Providers](/reference/tts-providers) |
 | `stt` | `string \| STTConfig` | STT provider — shortcut or full config |
 | `llm` | `LLMConfig` | LLM provider, model, prompt, enabled flag |
 | `tools` | `Tool[]` | Declarative tools created with `tool()` + Zod schemas (auto-executed) |

package/skills/pinecall-security/SKILL.md

@@ -30,7 +30,9 @@ table below indexes every page; open the `references/…` file for the full text
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-web-chat/SKILL.md

@@ -31,7 +31,9 @@ table below indexes every page; open the `references/…` file for the full text
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-web-components/SKILL.md

@@ -30,7 +30,9 @@ table below indexes every page; open the `references/…` file for the full text
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-web-voice/SKILL.md

@@ -33,7 +33,9 @@ table below indexes every page; open the `references/…` file for the full text
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.

package/skills/pinecall-web-widget/SKILL.md

@@ -34,7 +34,9 @@ table below indexes every page; open the `references/…` file for the full text
 - **TTS model is auto-derived from `language`** — non-English agents (e.g.
   `language: "es"`) default ElevenLabs to `eleven_multilingual_v2` so numbers,
   dates and currency are pronounced correctly (flash/turbo don't normalize text).
-  English stays on `eleven_flash_v2_5`. Override with `voice: { ..., model: "..." }`.
+  English stays on `eleven_flash_v2_5`. To keep flash on a non-English agent
+  (lower latency/cost), set the top-level `flash: true` flag. To pin any model,
+  use `voice: { ..., model: "..." }` (explicit model always wins over `flash`).
 - **Greeting**: inbound → `greeting` field in `pc.agent()`; outbound → `greeting`
   field in `agent.dial()`. It is sugar for `call.say()` in `call.started`.
 - **Auth**: `new Pinecall()` reads `PINECALL_API_KEY` from env and auto-connects.