@letta-ai/letta-code 0.34.10 → 0.34.11

package/npm-shrinkwrap.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.34.10",
+  "version": "0.34.11",
   "lockfileVersion": 3,
   "packages": {
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -3687,9 +3687,9 @@
       }
     },
     "node_modules/ip-address": {
-      "version": "10.7.3",
-      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.7.3.tgz",
-      "integrity": "sha512-A1kdq/tSb5QjvKvAMgIoEvDBIgL7qaqVP/jkvSwYYRZ9iEzvPpopxp2wQfu3SuZRHtpHNxMn8Fs0bS+gf5Xmwg==",
+      "version": "10.7.4",
+      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.7.4.tgz",
+      "integrity": "sha512-DWBMKyeM25D70nrIiTkgQth59/G+naKOTep6huF9j+GmeK3DMD60Zvxg5d5qQnz+38AHgou6ean2LECX+lrKDg==",
       "license": "MIT",
       "engines": {
         "node": ">= 12"
@@ -5423,9 +5423,9 @@
       "license": "MIT"
     },
     "node_modules/zod": {
-      "version": "4.6.5",
-      "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.5.tgz",
-      "integrity": "sha512-v5l/aFXZQeai4awLbOpSoHecE9UiMrnfx75tEXLjNonXVARxQ5mOeipTjROUchszUNCqnE+hqAMujRsRHsut2Q==",
+      "version": "4.6.6",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.6.tgz",
+      "integrity": "sha512-4UmzQUF5fxvfcYHlbjBmejU+w+hbDnWFx4aS8kBx7nPBHcO2SqPbpAG8snbdg+Xse4pRefR98hgjFgIMCI/UhA==",
       "license": "MIT",
       "funding": {
         "url": "https://github.com/sponsors/colinhacks"
@@ -5452,7 +5452,7 @@
     },
     "": {
       "name": "@letta-ai/letta-code",
-      "version": "0.34.10",
+      "version": "0.34.11",
       "dependencies": {
         "@earendil-works/pi-ai": "^0.99.1",
         "@janhapke/sharp-electron": "0.35.3-electron.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.34.10",
+  "version": "0.34.11",
   "lettaStartupLogProtocol": 1,
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",
@@ -275,5 +275,5 @@
   },
   "lettaLifecycleProtocol": 1,
   "lettaRuntimeGraphProtocol": 1,
-  "lettaRuntimeGraphSha512": "sha512-lczEOCQ1aWWj8tVKrpJI/TA+R/3FSly2v84UKu01LIauxoWbNzFdEpoXpXLjSlrwIvjnrFyCkpe+ue5lmFVc4w=="
+  "lettaRuntimeGraphSha512": "sha512-R2czT+w/9GF9edoE5k4YkzYyy9hALZjCA1uusJFAsnBKCQHlzE+5Kv4ZIVrBOA1oHPHcr8c08zc00L4q8oYLjA=="
 }

package/skills/speech-generation/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ElevenLabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/speech-generation/SKILL.md

@@ -0,0 +1,216 @@
+---
+name: speech-generation
+description: Convert text to speech using ElevenLabs voice AI through Letta. Use when generating audio from text, sending a voice message, reading text aloud, creating voiceovers, speaking in your own voice, or synthesizing speech in 90+ languages.
+license: MIT
+---
+
+# ElevenLabs Text-to-Speech (via Letta)
+
+Generate natural speech from text - supports 90+ languages, multiple models for quality vs latency tradeoffs. Examples default to `eleven_v4`, the latest and highest-quality model.
+
+This skill is adapted from ElevenLabs' `text-to-speech` skill
+([elevenlabs/skills](https://github.com/elevenlabs/skills), MIT; see `LICENSE`).
+Instead of calling ElevenLabs with your own key, you call Letta's hosted endpoint
+`POST /v1/audio/speech`. It forwards the request to ElevenLabs with Letta's key
+and charges the organization's Letta credits, so you do not need an ElevenLabs
+API key. The request body uses the same field names as ElevenLabs "Create
+speech"; the voice ID goes in the body.
+
+## Quick Start
+
+```bash
+base_url="${LETTA_BASE_URL%/}"
+
+curl -sS -X POST "$base_url/v1/audio/speech" \
+  -H "Authorization: Bearer $LETTA_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"text":"Hello, welcome to ElevenLabs!","voice_id":"JBFqnCBsd6RMkjVDRZzb","model_id":"eleven_v4"}' \
+  > speech-response.json
+
+python3 - <<'PY'
+import base64, json
+
+with open("speech-response.json") as f:
+    response = json.load(f)
+if "audio_b64" not in response:
+    raise SystemExit(response.get("message", response))
+
+with open("output.mp3", "wb") as f:
+    f.write(base64.b64decode(response["audio_b64"]))
+print("saved output.mp3")
+PY
+```
+
+Use the runtime-provided `LETTA_BASE_URL` and `LETTA_API_KEY` together. Build
+URLs relative to `${LETTA_BASE_URL%/}` and do not hardcode
+`https://api.letta.com`. If either variable is missing, the user needs to
+authenticate with Letta Cloud; do not ask for an ElevenLabs key.
+
+Share the saved file the way your current surface supports: attach or upload it
+to the conversation or channel you are replying in. Never paste the base64 into
+a reply. Keep credit amounts out of replies unless the user asks about cost.
+
+## Models
+
+| Model ID | Languages | Latency | Best For |
+|----------|-----------|---------|----------|
+| `eleven_v4` | 90+ | Standard | **Default.** Highest quality, emotional range, audio tags, voice cloning accuracy |
+| `eleven_v4_turbo` | 90+ | ~100ms | Faster v4 for shorter, time-sensitive replies |
+| `eleven_flash_v2_5` | 32 | ~75ms | Lowest latency, lowest cost |
+| `eleven_flash_v2` | English | ~75ms | English-only, lowest latency |
+| `eleven_multilingual_v2` | 29 | Standard | Previous generation; most stable on very long-form generations |
+| `eleven_v3` | 70+ | Standard | Previous generation expressive model |
+
+`eleven_turbo_v2_5` and `eleven_turbo_v2` are superseded by the Flash models (same output, lower latency) — use `eleven_flash_v2_5` / `eleven_flash_v2` instead.
+
+**Eleven v4 notes:** supports only `stability` and `similarity_boost` voice settings (no `style` or `speed`) and does not support SSML. Direct delivery with audio tags such as `[whispers]`, `[laughs]`, `[sarcastic]` (see "Audio Tags").
+
+## Voice IDs
+
+The Letta endpoint accepts ElevenLabs premade voices and voices Letta provides.
+If your memory names your own voice ID, use it whenever you speak as yourself.
+Other voices (cloned or designed voices from someone's own ElevenLabs account)
+are rejected with 400; to use one, call ElevenLabs directly with the user's own
+`ELEVENLABS_API_KEY` secret and ElevenLabs' `text-to-speech` skill.
+
+**Premade voices:**
+- `JBFqnCBsd6RMkjVDRZzb` - George (male, warm storyteller)
+- `EXAVITQu4vr4xnSDxMaL` - Sarah (female, mature, reassuring)
+- `cgSgspJ2msm6clMCkdW9` - Jessica (female, playful, conversational)
+- `onwK4e9ZLuTAKqWW03F9` - Daniel (male, steady broadcaster)
+- `SAz9YHcvj6GT2YYXdXww` - River (neutral, relaxed)
+
+## Voice Settings
+
+Fine-tune how the voice sounds:
+
+- **Stability**: How consistent the voice stays. Lower values = more emotional range and variation, but can sound unstable. Higher = steady, predictable delivery.
+- **Similarity boost**: How closely to match the original voice sample. Higher values sound more like the original but may amplify audio artifacts.
+- **Style**: Exaggerates the voice's unique style characteristics (v2/v3 models; not supported on Eleven v4).
+- **Speed**: Speech speed multiplier (v2/v3 models; not supported on Eleven v4).
+- **Speaker boost**: Post-processing that enhances clarity and voice similarity.
+
+```json
+{
+  "text": "Customize my voice settings.",
+  "voice_id": "JBFqnCBsd6RMkjVDRZzb",
+  "model_id": "eleven_v4",
+  "voice_settings": {
+    "stability": 0.5,
+    "similarity_boost": 0.75
+  }
+}
+```
+
+`stability`: lower = more expressive, higher = more consistent.
+`similarity_boost`: higher = closer to the reference voice. See
+[references/voice-settings.md](references/voice-settings.md) for ranges and
+use-case presets.
+
+## Audio Tags
+
+Eleven v4 reads bracketed, natural-language cues in `text` as stage directions:
+
+- Place a tag before the words it affects: `[shouts] I can't believe you said that to me.`
+- A tag's emotion carries forward, so add another tag only where the delivery should shift.
+- Combine tags inside one set of brackets: `[whispering, playful]`. Plain-language tags work, such as `[nervous, trying to sound confident]` or `[phone buzzing]`.
+- Use one emotion per clause; contrasting tags on the same words blur the performance.
+- Pair tags with punctuation: ellipses slow a line, dashes cut a speaker off, and `[pause]` / `[long pause]` add beats.
+- If a delivery misses, swap the tag (try `[let down]` instead of `[despair]`) and regenerate rather than rewriting the line.
+
+## Language Selection
+
+Use `language_code` with models that support language enforcement to guide pronunciation and text normalization. Unsupported language codes are ignored, and `language_code` is not supported on `eleven_multilingual_v2`.
+
+```json
+{
+  "text": "Bonjour, comment allez-vous?",
+  "voice_id": "JBFqnCBsd6RMkjVDRZzb",
+  "model_id": "eleven_v4",
+  "language_code": "fr"
+}
+```
+
+## Text Normalization
+
+Controls how numbers, dates, and abbreviations are converted to spoken words. For example, "01/15/2026" becomes "January fifteenth, twenty twenty-six":
+
+- `"auto"` (default): Model decides based on context
+- `"on"`: Always normalize (use when you want natural speech)
+- `"off"`: Speak literally (use when you want "zero one slash one five...")
+
+```json
+{
+  "text": "Call 1-800-555-0123 on 01/15/2026",
+  "voice_id": "JBFqnCBsd6RMkjVDRZzb",
+  "model_id": "eleven_v4",
+  "apply_text_normalization": "on"
+}
+```
+
+## Request Stitching
+
+When generating long audio in multiple requests, the audio can have pops, unnatural pauses, or tone shifts at the boundaries. Request stitching solves this by letting each request know what comes before/after it:
+
+```json
+{"text": "This is the first part.", "voice_id": "JBFqnCBsd6RMkjVDRZzb", "model_id": "eleven_v4", "next_text": "And this continues the story."}
+```
+
+```json
+{"text": "And this continues the story.", "voice_id": "JBFqnCBsd6RMkjVDRZzb", "model_id": "eleven_v4", "previous_text": "This is the first part."}
+```
+
+Each response includes `request_id`. Instead of `previous_text`, you can pass up
+to three earlier `request_id` values in `previous_request_ids` (and later ones in
+`next_request_ids` when regenerating a middle part). Keep the same voice, model,
+and voice settings for every part, split long text at sentence or paragraph
+boundaries (each request takes up to 10,000 characters), and concatenate the
+files in order, for example with `ffmpeg -f concat`.
+
+## Output Formats
+
+Pass `output_format` in the body.
+
+| Format | Description |
+|--------|-------------|
+| `mp3_44100_128` | MP3 44.1kHz 128kbps (default) - compressed, good for web/apps |
+| `mp3_44100_192` | MP3 44.1kHz 192kbps - higher quality compressed |
+| `mp3_44100_64` | MP3 44.1kHz 64kbps - lower quality, smaller files |
+| `mp3_22050_32` | MP3 22.05kHz 32kbps - smallest MP3 files |
+| `pcm_16000` | Raw PCM 16kHz - use for real-time processing |
+| `pcm_22050` | Raw PCM 22.05kHz |
+| `pcm_24000` | Raw PCM 24kHz |
+| `pcm_44100` | Raw PCM 44.1kHz - CD quality |
+| `pcm_48000` | Raw PCM 48kHz - highest quality |
+| `ulaw_8000` | μ-law 8kHz - standard for phone systems (Twilio, telephony) |
+| `alaw_8000` | A-law 8kHz - telephony (alternative to μ-law) |
+| `opus_48000_64` | Opus 48kHz 64kbps - efficient codec, small files |
+| `wav_44100` | WAV 44.1kHz - uncompressed with headers |
+
+The Letta endpoint returns the whole file at once (as `audio_b64`); it does not stream.
+
+## Response
+
+```json
+{
+  "model_id": "eleven_v4",
+  "voice_id": "JBFqnCBsd6RMkjVDRZzb",
+  "output_format": "mp3_44100_128",
+  "audio_b64": "<base64>",
+  "request_id": "Frhov0LQNC3M9HcHKY3t",
+  "characters": 46,
+  "billing": { "credits_charged": 4, "transaction_id": "...", "new_credit_balance": "..." }
+}
+```
+
+## Error Handling
+
+Errors return JSON with a `message`:
+- **400 "Voice … is not available"**: use your own voice or a premade voice (see "Voice IDs").
+- **400 with an ElevenLabs message**: invalid parameters (check `model_id`, voice settings the model does not support, or text length).
+- **402**: the organization is out of Letta credits. Tell the user; do not retry.
+- **500**: retry once, then report the failure.
+
+## References
+
+- [Voice Settings](references/voice-settings.md)

package/skills/speech-generation/references/voice-settings.md

@@ -0,0 +1,68 @@
+# Voice Settings
+
+Fine-tune voice characteristics for your use case. Adapted from ElevenLabs'
+`text-to-speech` skill (MIT; see `../LICENSE`), with examples rewritten for
+Letta's `POST /v1/audio/speech` request body.
+
+## Parameters
+
+| Parameter | Range | Default | Description |
+|-----------|-------|---------|-------------|
+| `stability` | 0.0 - 1.0 | 0.5 | How consistent the voice sounds across the generation. Lower = more emotional variation and expressiveness (but can sound erratic). Higher = steady, predictable tone. |
+| `similarity_boost` | 0.0 - 1.0 | 0.75 | How closely to match the original voice sample. Higher sounds more like the source voice but may amplify audio artifacts or background noise from the original recording. |
+| `style` | 0.0 - 1.0 | 0.0 | Exaggerates the unique characteristics of the voice's speaking style (v2 and v3 models; not supported on Eleven v4). Higher values make the voice more "characterful" but can reduce stability. |
+| `speed` | 0.25 - 4.0 | 1.0 | Speech speed multiplier. 1.0 = normal speed. Not supported on Eleven v4. |
+| `use_speaker_boost` | boolean | true | Post-processing that enhances voice clarity and similarity to the original. Generally leave this on unless you're experiencing artifacts. |
+
+**Eleven v4** (`eleven_v4`, `eleven_v4_turbo`) uses only `stability` and `similarity_boost`. Control pacing and emotion with audio tags (`[whispers]`, `[excited]`, `[sighs]`) and punctuation (ellipses for pauses, capitals for emphasis) instead of `style`/`speed`. SSML is not supported on v4.
+
+## Example
+
+```json
+{
+  "text": "Testing different voice settings.",
+  "voice_id": "JBFqnCBsd6RMkjVDRZzb",
+  "model_id": "eleven_v4",
+  "voice_settings": {
+    "stability": 0.5,
+    "similarity_boost": 0.75
+  }
+}
+```
+
+## Use Case Recommendations
+
+These presets work with `eleven_v4`. On v2/v3 models you can also add `style` for extra character.
+
+### Audiobooks / Narration
+```json
+{ "stability": 0.7, "similarity_boost": 0.5 }
+```
+Consistent tone, natural variation.
+
+### Conversational / Chatbots
+```json
+{ "stability": 0.4, "similarity_boost": 0.75 }
+```
+More expressive.
+
+### News / Professional
+```json
+{ "stability": 0.8, "similarity_boost": 0.6 }
+```
+Very consistent.
+
+### Character Voices / Drama
+```json
+{ "stability": 0.3, "similarity_boost": 0.8 }
+```
+Highly expressive. Add delivery direction in the text: `"[excited] We did it! [laughs]"`
+
+## Tips
+
+- **Start with defaults** and adjust incrementally
+- **Lower stability** if voice sounds monotonous
+- **Reduce similarity_boost** if you hear audio artifacts
+- **Style and speed** work with v2 and v3 models only; on v4 use audio tags and punctuation
+- **Test with representative text** from your actual use case
+- **Flash models** ignore some voice settings for speed

package/skills/submitting-feedback/SKILL.md

@@ -24,12 +24,14 @@ If the user says yes, or directly asks you to submit feedback:
    - Concrete evidence already available, such as exact error text, the failed command or action, relevant paths or links, and reliable reproduction steps. Distinguish what the user reported from what you observed or inferred.
 
    Prefer specific nouns and observable behavior over generic judgments. Do not submit context-free summaries such as “the feature is broken,” “the UX should be improved,” or polished product-language filler. Keep unknowns explicit rather than guessing.
-3. Submit it with:
+3. Write the report to a temporary text file, then submit it with:
 
 ```bash
-letta feedback --message '<feedback>'
+letta feedback --message-file <path-to-report>
 ```
 
+   Pass the report as a file rather than inline with `--message`: multi-line command arguments can be cut off at the first line on some platforms (Windows routes `letta` through a `.cmd` shim).
+
 4. Tell the user whether submission succeeded. If it failed, report the safe CLI error and do not claim the team received it.
 
 Do not include secrets, credentials, unrelated conversation content, or private file contents. The command adds the current agent and conversation identifiers so the team can find the relevant run.