@llblab/pi-kit 0.3.2 → 0.4.0

package/node_modules/@llblab/skills/domain-dag/scripts/validate-domain-dag.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd -P)"
+exec node "$SCRIPT_DIR/validate-domain-dag.mjs" "$@"

package/node_modules/@llblab/skills/edge-tts/AGENTS.md

@@ -0,0 +1,19 @@
+# AGENTS.md (edge-tts)
+
+[SKILL.md](./SKILL.md) owns the client architecture, invocation, output modes, and platform playback behavior.
+
+### Operating Principles
+
+- Preserve the Skill's client architecture; keep the Bash entrypoint a delegation-only wrapper.
+- In playback mode, print only the spoken text to stdout; send diagnostics to stderr.
+- Preserve the Skill's stdin and positional interfaces for piped responses and existing `say_edge` callers.
+
+### Playback Policy
+
+- Auto-detect blocking players in this order: `ffplay`, `mpv`, `vlc`, `cvlc`, `mpg123`, `afplay`, before the Skill's Windows fallback.
+- Keep media, subtitle, metadata, and voice-list operations independent of player availability.
+
+### Discovered Constraints
+
+- Direct Edge binary websocket payload data begins immediately after the declared header bytes; do not skip an extra CRLF after the binary header.
+- MP3 output should start with a valid frame sync such as `ff f3`; missing sync means audio chunks were sliced incorrectly.

package/node_modules/@llblab/skills/edge-tts/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: edge-tts
+description: Text-to-speech via Microsoft Edge TTS (free, neural voices).
+---
+
+# Edge TTS
+
+Direct Node.js client for Microsoft Edge's online TTS service. The canonical client is `scripts/say.mjs`; `scripts/say.sh` is the shell entrypoint wrapper. There are no Python, CLI-wrapper, or legacy shell fallbacks.
+
+## Usage
+
+```bash
+./scripts/say.sh "Привет" ru +30%             # Synthesize and play with an available local MP3 player
+./scripts/say.sh "Привет" ru 1 /tmp/hello.mp3 # Save MP3; numeric rate multiplier is supported
+./scripts/say.sh "Привет" ru +30% /tmp/a.mp3 /tmp/a.jsonl
+./scripts/say.sh --text "Hello" --lang en --write-media /tmp/hello.mp3
+./scripts/say.sh --file input.txt --voice ru-RU-SvetlanaNeural --write-media out.mp3 --write-subtitles out.srt
+./scripts/say.sh --list-voices
+```
+
+## CLI Options
+
+- `--text`, `--file` — text source; `-` means stdin for files.
+- `--lang`, `--voice` — language shortcut or explicit voice.
+- `--rate`, `--volume`, `--pitch` — Edge prosody controls.
+- `--boundary` — `SentenceBoundary` or `WordBoundary`.
+- `--write-media` — MP3 output path; `-` means stdout.
+- `--write-subtitles` — SRT output path; `-` means stderr.
+- `--write-metadata` — JSONL boundary metadata output path.
+- `--list-voices` — direct voice list request.
+
+## Playback
+
+Playback runs in background only when no media output path is provided. The client auto-detects a local MP3 player and removes the temp file after playback when the player is blocking.
+
+Default candidates:
+
+- Cross-platform if installed: `ffplay`, `mpv`, `vlc`/`cvlc`.
+- Linux/BSD extras: `mpg123`.
+- macOS default: `afplay`.
+- Windows default fallback: the system-registered MP3 app through PowerShell `Start-Process`.
+
+If no player exists, generation is still available through `--write-media`; the agent can then play the MP3 with any system-specific tool. Windows default-app playback uses delayed temp cleanup because registered apps usually detach immediately.
+
+## Dependencies
+
+- Node.js 18+.
+- A local MP3 player only for direct playback mode.
+- Internet access.
+
+## Notes
+
+- Built-in language shortcuts: en, ru, de, fr, es, it, zh, ja.
+- Default rate: +30%.
+- Rate/volume accept Edge percent strings and numeric multipliers: `1` = `+100%`, `0.8` = `+80%`, `-0.5` = `-50%`.
+- The script implements direct TLS/WebSocket handshake, MUID, Sec-MS-GEC, MP3 streaming, boundary metadata, subtitles, and voice listing.

package/node_modules/@llblab/skills/edge-tts/recipes/say-edge.json

@@ -0,0 +1,9 @@
+{
+  "description": "Synthesize speech from text through the Edge TTS skill.",
+  "args": [
+    "text:string",
+    "lang:string=ru",
+    "rate:string=+30%"
+  ],
+  "template": "{skill_dir}/scripts/say.sh {text} {lang} {rate}"
+}