tts-plugin-bridge 0.1.0__tar.gz

tts_plugin_bridge-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environment
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+
+# Build
+build/
+dist/
+
+# Cache
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+
+# Logs
+*.log
+
+# Environment variables
+.env
+.env.local
+
+# Lock files
+uv.lock
+
+# Generated
+.coverage
+GEMINI.md

tts_plugin_bridge-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vox4ai
+
+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.

tts_plugin_bridge-0.1.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: tts-plugin-bridge
+Version: 0.1.0
+Summary: TTSプラグインの動的発見・管理・Agent連携のためのコアフレームワーク
+Project-URL: Homepage, https://github.com/vox4ai/tts-plugin-bridge
+Project-URL: Repository, https://github.com/vox4ai/tts-plugin-bridge
+Project-URL: Issues, https://github.com/vox4ai/tts-plugin-bridge/issues
+Author-email: utenadev <utena.cross+pypi@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent-skill,plugin-system,speech,synthesis,tts,tts-plugin,voice
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic>=2.0
+Description-Content-Type: text/markdown
+
+# tts-plugin-bridge
+
+<p align="center">
+  <img src="https://via.placeholder.com/1200x400/1a1a1a/ffffff?text=tts-plugin-bridge" alt="tts-plugin-bridge Banner" width="1200">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/pypi-latest-blue.svg" alt="PyPI version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/python-3.10%2B-yellow.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/maintained%3F-yes-brightgreen.svg" alt="Maintained">
+</p>
+
+<p align="center">
+  <a href="https://github.com/vox4ai/tts-plugin-bridge">Website</a> •
+  <a href="https://github.com/vox4ai/tts-plugin-bridge/issues">Report Bug</a> •
+  <a href="https://github.com/vox4ai/tts-plugin-bridge/contributing">Contributing</a>
+</p>
+
+---
+
+## 🚀 Overview
+
+TTSエンジンのプラグイン化・動的発見・Agent連携を可能にするコアフレームワークです。
+
+### ✨ 特徴
+- 🔌 **Entry Points による自動発見**: `uv add tts-plugin-xxx` するだけで自動的にブリッジへ登録
+- 🔀 **エンジン非依存**: コアパッケージは特定のTTSに依存せず、軽量で安定
+- 🤖 **Agent 最適化**: `TTSSkill` クラスで非同期呼び出し・パラメータ統一・Base64出力を標準提供
+- 🛡️ **型安全**: Pydantic ベースのリクエスト/レスポンスでバリデーション自動実行
+- 🎤 **vox4ai CLI**: 統一インターフェースの `vox4ai` コマンドを同梱（say/save/list/test + 環境診断）
+
+## 🧩 TTS Engine プラグイン
+
+各 TTS Engine は独立したプラグインとして提供されます。
+`uv add tts-plugin-<name>` で導入するだけです。
+
+| プラグイン | リポジトリ | バックエンド | 特徴 |
+|---|---|---|---|
+| **tts-plugin-edgetts** | [vox4ai/tts-plugin-edgetts](https://github.com/vox4ai/tts-plugin-edgetts) | [edge-tts](https://github.com/rany2/edge-tts) (Microsoft Edge TTS) | ローカルサーバー不要・APIキー不要・すぐ使える・多言語・ffplayストリーミング再生 |
+| **tts-plugin-aivisspeech** | [vox4ai/tts-plugin-aivisspeech](https://github.com/vox4ai/tts-plugin-aivisspeech) | [AivisSpeech Engine](https://github.com/AivisProject/AivisSpeech-Engine) | VOICEVOX互換API・日本語高品質・Docker運用・複数話者・WAV出力 |
+| **tts-plugin-kokoro** | [vox4ai/tts-plugin-kokoro](https://github.com/vox4ai/tts-plugin-kokoro) | [kokoro](https://github.com/hexgrad/kokoro) (ローカル推論) | 完全オフライン・espeak-ng必要・モデル別途DL・ローカル音声合成 |
+| **tts-plugin-piperplus** | [vox4ai/tts-plugin-piperplus](https://github.com/vox4ai/tts-plugin-piperplus) | [Piper](https://github.com/rhasspy/piper) / Piper Plus HTTP Server | 軽量・Raspberry Piでも動作・ローカルHTTPサーバー |
+| **tts-plugin-voisonatalk** | [vox4ai/tts-plugin-voisonatalk](https://github.com/vox4ai/tts-plugin-voisonatalk) | [VoiSona Talk Editor](https://resource.voisona.com/) (REST API) | 歌声・読み上げ対応・Windows/Mac・BasicAuth認証・直接スピーカー出力 |
+
+> 全て `uv add tts-plugin-<name>` で bridge プロジェクトに追加できます。`vox4ai list` で導入済みプラグインを確認できます。
+
+## 📦 インストール
+
+```bash
+uv add tts-plugin-bridge
+```
+
+## 🛠 Usage
+
+### 🧩 Python API
+
+```python
+from tts_plugin_bridge import TTSSkill
+
+async with TTSSkill(default_engine="edgetts") as skill:
+    # 音声ファイルに保存（save は synthesize の alias）
+    res = await skill.save(
+        text="こんにちは",
+        speed=1.2,
+        volume=1.0,
+    )
+    with open("output.mp3", "wb") as f:
+        f.write(base64.b64decode(res["audio_base64"]))
+
+    # 直接再生（say は play の alias）
+    res = await skill.say(
+        text="こんにちは",
+        model="ja-JP-KeitaNeural",
+    )
+```
+
+#### メソッド一覧
+
+| メソッド | alias | 戻り値 | 用途 |
+|----------|-------|--------|------|
+| `synthesize()` | `save()` | `dict` (Base64) | 音声合成してBase64として返す |
+| `play()` | `say()` | `dict` | 直接再生（ストリーミング優先→全取得後再生） |
+| `close()` | - | `None` | 全コネクタのリソース解放 |
+
+- `say()` / `play()` は Engine が `synthesize_stream()` を実装していれば ffplay でストリーミング、なければ synthesize → paplay/aplay で再生
+- Engine ごとに再生方式が異なるが、ユーザーは `say()` という同じインターフェースで使える
+
+### 🎤 vox4ai CLI
+
+`vox4ai` は `tts-plugin-bridge` に同梱される統合TTS操作コマンドです。
+サブコマンドで直感的に操作できます。
+
+```bash
+vox4ai say "こんにちは"
+vox4ai save "こんにちは" -o output.wav
+vox4ai list
+vox4ai test -e aivisspeech
+```
+
+#### グローバルオプション
+
+```bash
+vox4ai --commands              # 利用可能なサブコマンド一覧
+vox4ai --doctor                # 環境診断（再生コマンド・プラグイン・パッケージ）
+vox4ai --tts-plugin-list       # TTS Engine 一覧（listと同じ）
+```
+
+#### `vox4ai --doctor` で確認できる項目
+- 再生コマンド: ffplay / paplay / aplay の有無
+- 登録TTSプラグイン一覧
+- Python パッケージ導入状況
+
+#### サブコマンド
+
+##### `say` — テキストを読み上げる（ストリーミング再生優先）
+
+```bash
+vox4ai say "こんにちは"                        # デフォルトエンジン
+vox4ai say "Hello" -e edgetts                 # Edge TTS（ffplayストリーミング）
+vox4ai say "こんにちは" -e aivisspeech          # AivisSpeech
+  --server-url http://localhost:10101
+  --style-id 888753760
+vox4ai say "Hello" -e edgetts                 # 話速・声指定
+  --speed 1.5
+  --model en-US-AndrewNeural
+```
+
+##### `save` — テキストを音声ファイルに保存
+
+```bash
+vox4ai save "こんにちは" -o hello.wav           # WAV保存
+vox4ai save "こんにちは" -e edgetts -o out.mp3  # Edge TTS（MP3）
+vox4ai save "こんにちは" -e aivisspeech          # AivisSpeech
+  --server-url http://localhost:10101
+  --style-id 888753760
+  --output hello.wav
+vox4ai save "こんにちは" --play                 # 保存後に再生
+```
+
+##### `list` — 利用可能なTTSプラグイン一覧
+
+```bash
+vox4ai list
+```
+
+##### `test` — TTSエンジン接続テスト
+
+```bash
+vox4ai test -e edgetts
+vox4ai test -e aivisspeech --server-url http://localhost:10101 --style-id 888753760
+```
+
+### ヘルプ
+
+```bash
+vox4ai --help            # 全体ヘルプ
+vox4ai say --help        # say サブコマンドのヘルプ
+vox4ai save --help       # save サブコマンドのヘルプ
+```
+
+## 🔧 プラグイン開発者向け
+
+独自のTTSエンジンをプラグイン化するには、`pyproject.toml` にエントリーポイントを定義するだけです。
+詳細は各プラグインリポジトリのドキュメントを参照してください。
+
+## 🔍 検証環境
+
+- **OS**: Windows 11 + WSL2 (Ubuntu)
+- **確認日**: 2026-05-09
+- **確認プラグイン**: aivisspeech (Engine v1.2.0), edgetts (edge-tts v7.2.8), kokoro
+- **確認内容**:
+  - `vox4ai say` / `save` / `list` / `test` / `--doctor` / `--commands` 全動作確認
+  - 全ユニットテストパス: bridge 11件, aivisspeech 16件, edgetts 22件
+
+## 📜 ライセンス
+
+MIT License

tts_plugin_bridge-0.1.0/README.md

@@ -0,0 +1,178 @@
+# tts-plugin-bridge
+
+<p align="center">
+  <img src="https://via.placeholder.com/1200x400/1a1a1a/ffffff?text=tts-plugin-bridge" alt="tts-plugin-bridge Banner" width="1200">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/pypi-latest-blue.svg" alt="PyPI version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/python-3.10%2B-yellow.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/maintained%3F-yes-brightgreen.svg" alt="Maintained">
+</p>
+
+<p align="center">
+  <a href="https://github.com/vox4ai/tts-plugin-bridge">Website</a> •
+  <a href="https://github.com/vox4ai/tts-plugin-bridge/issues">Report Bug</a> •
+  <a href="https://github.com/vox4ai/tts-plugin-bridge/contributing">Contributing</a>
+</p>
+
+---
+
+## 🚀 Overview
+
+TTSエンジンのプラグイン化・動的発見・Agent連携を可能にするコアフレームワークです。
+
+### ✨ 特徴
+- 🔌 **Entry Points による自動発見**: `uv add tts-plugin-xxx` するだけで自動的にブリッジへ登録
+- 🔀 **エンジン非依存**: コアパッケージは特定のTTSに依存せず、軽量で安定
+- 🤖 **Agent 最適化**: `TTSSkill` クラスで非同期呼び出し・パラメータ統一・Base64出力を標準提供
+- 🛡️ **型安全**: Pydantic ベースのリクエスト/レスポンスでバリデーション自動実行
+- 🎤 **vox4ai CLI**: 統一インターフェースの `vox4ai` コマンドを同梱（say/save/list/test + 環境診断）
+
+## 🧩 TTS Engine プラグイン
+
+各 TTS Engine は独立したプラグインとして提供されます。
+`uv add tts-plugin-<name>` で導入するだけです。
+
+| プラグイン | リポジトリ | バックエンド | 特徴 |
+|---|---|---|---|
+| **tts-plugin-edgetts** | [vox4ai/tts-plugin-edgetts](https://github.com/vox4ai/tts-plugin-edgetts) | [edge-tts](https://github.com/rany2/edge-tts) (Microsoft Edge TTS) | ローカルサーバー不要・APIキー不要・すぐ使える・多言語・ffplayストリーミング再生 |
+| **tts-plugin-aivisspeech** | [vox4ai/tts-plugin-aivisspeech](https://github.com/vox4ai/tts-plugin-aivisspeech) | [AivisSpeech Engine](https://github.com/AivisProject/AivisSpeech-Engine) | VOICEVOX互換API・日本語高品質・Docker運用・複数話者・WAV出力 |
+| **tts-plugin-kokoro** | [vox4ai/tts-plugin-kokoro](https://github.com/vox4ai/tts-plugin-kokoro) | [kokoro](https://github.com/hexgrad/kokoro) (ローカル推論) | 完全オフライン・espeak-ng必要・モデル別途DL・ローカル音声合成 |
+| **tts-plugin-piperplus** | [vox4ai/tts-plugin-piperplus](https://github.com/vox4ai/tts-plugin-piperplus) | [Piper](https://github.com/rhasspy/piper) / Piper Plus HTTP Server | 軽量・Raspberry Piでも動作・ローカルHTTPサーバー |
+| **tts-plugin-voisonatalk** | [vox4ai/tts-plugin-voisonatalk](https://github.com/vox4ai/tts-plugin-voisonatalk) | [VoiSona Talk Editor](https://resource.voisona.com/) (REST API) | 歌声・読み上げ対応・Windows/Mac・BasicAuth認証・直接スピーカー出力 |
+
+> 全て `uv add tts-plugin-<name>` で bridge プロジェクトに追加できます。`vox4ai list` で導入済みプラグインを確認できます。
+
+## 📦 インストール
+
+```bash
+uv add tts-plugin-bridge
+```
+
+## 🛠 Usage
+
+### 🧩 Python API
+
+```python
+from tts_plugin_bridge import TTSSkill
+
+async with TTSSkill(default_engine="edgetts") as skill:
+    # 音声ファイルに保存（save は synthesize の alias）
+    res = await skill.save(
+        text="こんにちは",
+        speed=1.2,
+        volume=1.0,
+    )
+    with open("output.mp3", "wb") as f:
+        f.write(base64.b64decode(res["audio_base64"]))
+
+    # 直接再生（say は play の alias）
+    res = await skill.say(
+        text="こんにちは",
+        model="ja-JP-KeitaNeural",
+    )
+```
+
+#### メソッド一覧
+
+| メソッド | alias | 戻り値 | 用途 |
+|----------|-------|--------|------|
+| `synthesize()` | `save()` | `dict` (Base64) | 音声合成してBase64として返す |
+| `play()` | `say()` | `dict` | 直接再生（ストリーミング優先→全取得後再生） |
+| `close()` | - | `None` | 全コネクタのリソース解放 |
+
+- `say()` / `play()` は Engine が `synthesize_stream()` を実装していれば ffplay でストリーミング、なければ synthesize → paplay/aplay で再生
+- Engine ごとに再生方式が異なるが、ユーザーは `say()` という同じインターフェースで使える
+
+### 🎤 vox4ai CLI
+
+`vox4ai` は `tts-plugin-bridge` に同梱される統合TTS操作コマンドです。
+サブコマンドで直感的に操作できます。
+
+```bash
+vox4ai say "こんにちは"
+vox4ai save "こんにちは" -o output.wav
+vox4ai list
+vox4ai test -e aivisspeech
+```
+
+#### グローバルオプション
+
+```bash
+vox4ai --commands              # 利用可能なサブコマンド一覧
+vox4ai --doctor                # 環境診断（再生コマンド・プラグイン・パッケージ）
+vox4ai --tts-plugin-list       # TTS Engine 一覧（listと同じ）
+```
+
+#### `vox4ai --doctor` で確認できる項目
+- 再生コマンド: ffplay / paplay / aplay の有無
+- 登録TTSプラグイン一覧
+- Python パッケージ導入状況
+
+#### サブコマンド
+
+##### `say` — テキストを読み上げる（ストリーミング再生優先）
+
+```bash
+vox4ai say "こんにちは"                        # デフォルトエンジン
+vox4ai say "Hello" -e edgetts                 # Edge TTS（ffplayストリーミング）
+vox4ai say "こんにちは" -e aivisspeech          # AivisSpeech
+  --server-url http://localhost:10101
+  --style-id 888753760
+vox4ai say "Hello" -e edgetts                 # 話速・声指定
+  --speed 1.5
+  --model en-US-AndrewNeural
+```
+
+##### `save` — テキストを音声ファイルに保存
+
+```bash
+vox4ai save "こんにちは" -o hello.wav           # WAV保存
+vox4ai save "こんにちは" -e edgetts -o out.mp3  # Edge TTS（MP3）
+vox4ai save "こんにちは" -e aivisspeech          # AivisSpeech
+  --server-url http://localhost:10101
+  --style-id 888753760
+  --output hello.wav
+vox4ai save "こんにちは" --play                 # 保存後に再生
+```
+
+##### `list` — 利用可能なTTSプラグイン一覧
+
+```bash
+vox4ai list
+```
+
+##### `test` — TTSエンジン接続テスト
+
+```bash
+vox4ai test -e edgetts
+vox4ai test -e aivisspeech --server-url http://localhost:10101 --style-id 888753760
+```
+
+### ヘルプ
+
+```bash
+vox4ai --help            # 全体ヘルプ
+vox4ai say --help        # say サブコマンドのヘルプ
+vox4ai save --help       # save サブコマンドのヘルプ
+```
+
+## 🔧 プラグイン開発者向け
+
+独自のTTSエンジンをプラグイン化するには、`pyproject.toml` にエントリーポイントを定義するだけです。
+詳細は各プラグインリポジトリのドキュメントを参照してください。
+
+## 🔍 検証環境
+
+- **OS**: Windows 11 + WSL2 (Ubuntu)
+- **確認日**: 2026-05-09
+- **確認プラグイン**: aivisspeech (Engine v1.2.0), edgetts (edge-tts v7.2.8), kokoro
+- **確認内容**:
+  - `vox4ai say` / `save` / `list` / `test` / `--doctor` / `--commands` 全動作確認
+  - 全ユニットテストパス: bridge 11件, aivisspeech 16件, edgetts 22件
+
+## 📜 ライセンス
+
+MIT License

tts_plugin_bridge-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tts-plugin-bridge"
+version = "0.1.0"
+description = "TTSプラグインの動的発見・管理・Agent連携のためのコアフレームワーク"
+requires-python = ">=3.10"
+dependencies = [
+    "pydantic>=2.0",
+    "pydantic-settings>=2.0",
+]
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "utenadev", email = "utena.cross+pypi@gmail.com"},
+]
+keywords = ["tts", "tts-plugin", "plugin-system", "voice", "speech", "synthesis", "agent-skill"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/vox4ai/tts-plugin-bridge"
+Repository = "https://github.com/vox4ai/tts-plugin-bridge"
+Issues = "https://github.com/vox4ai/tts-plugin-bridge/issues"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.3.0",
+    "pytest-cov>=6.0.0",
+    "ruff>=0.15.12",
+    "build>=1.0",
+    "twine>=6.0",
+    "vox4ai-skill-lib",
+]
+
+[tool.coverage.run]
+source = ["tts_plugin_bridge"]
+branch = true
+omit = ["*/tests/*", "*/__pycache__/*"]
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 50
+
+[tool.uv.sources]
+vox4ai-skill-lib = { path = "../vox4ai-skill-lib", editable = true }
+
+

tts_plugin_bridge-0.1.0/tests/test_chunker.py

@@ -0,0 +1,145 @@
+import pytest
+from tts_plugin_bridge.chunker import (
+    SentenceChunker,
+    CharacterCountChunker,
+    HybridChunker,
+    PauseMarkerChunker,
+)
+from tts_plugin_bridge.protocol import ChunkConfig, ChunkStrategy
+
+
+def test_sentence_chunker():
+    chunker = SentenceChunker()
+    config = ChunkConfig(strategy=ChunkStrategy.SENTENCE)
+
+    # 基本的な分割
+    text = "こんにちは。元気ですか？はい、元気です。"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) == 3
+    assert chunks[0].text == "こんにちは。"
+    assert chunks[1].text == "元気ですか？"
+    assert chunks[2].text == "はい、元気です。"
+
+    # 空のテキスト
+    assert chunker.chunk("", config) == []
+
+    # 句点がない場合
+    text = "こんにちは元気ですか"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) == 1
+    assert chunks[0].text == "こんにちは元気ですか"
+
+    # 1文字テキスト
+    chunks = chunker.chunk("あ", config)
+    assert len(chunks) == 1
+    assert chunks[0].text == "あ"
+
+
+def test_character_count_chunker():
+    chunker = CharacterCountChunker()
+    config = ChunkConfig(strategy=ChunkStrategy.CHARACTER_COUNT, max_chars=5)
+
+    # 基本的な分割
+    text = "あいうえおかきくけこ"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) == 2
+    assert chunks[0].text == "あいうえお"
+    assert chunks[1].text == "かきくけこ"
+
+    # 境界値: ちょうどmax_chars
+    text = "abcde"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) == 1
+    assert chunks[0].text == "abcde"
+
+    # 1文字テキスト
+    chunks = chunker.chunk("あ", config)
+    assert len(chunks) == 1
+    assert chunks[0].text == "あ"
+
+    # max_chars=1
+    config1 = ChunkConfig(strategy=ChunkStrategy.CHARACTER_COUNT, max_chars=1)
+    chunks = chunker.chunk("abc", config1)
+    assert len(chunks) == 3
+    assert chunks[0].text == "a"
+    assert chunks[1].text == "b"
+    assert chunks[2].text == "c"
+
+
+def test_hybrid_chunker():
+    chunker = HybridChunker()
+
+    # ケース 1: すべての文が max_chars 以下
+    config = ChunkConfig(strategy=ChunkStrategy.HYBRID, max_chars=50)
+    text = "短い文です。短い文です。"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) == 2
+    assert not any(c.is_partial for c in chunks)
+
+    # ケース 2: 文が max_chars を超える場合 (強制分割)
+    config = ChunkConfig(strategy=ChunkStrategy.HYBRID, max_chars=10)
+    text = "これは非常に長い文章なので、途中で切れるはずです。"
+    chunks = chunker.chunk(text, config)
+    assert any(c.is_partial for c in chunks)
+    assert chunks[0].char_count <= 10
+
+    # ケース 3: 句点がない長い文
+    text = "あいうえおかきくけこさしすせそたちつてと"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) > 1
+    assert any(c.is_partial for c in chunks)
+
+    # 空テキスト
+    assert chunker.chunk("", config) == []
+
+    # 1文字テキスト
+    chunks = chunker.chunk("あ", config)
+    assert len(chunks) == 1
+    assert chunks[0].text == "あ"
+
+
+def test_pause_marker_chunker():
+    chunker = PauseMarkerChunker()
+    config = ChunkConfig(strategy=ChunkStrategy.PAUSE_MARKERS, min_chars=5)
+
+    # 読点で分割
+    text = "本日は、晴天なり。明日は、雨でしょう。"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) >= 2
+    assert all(len(c.text) >= 5 for c in chunks)
+    assert (
+        chunks[0].text == "本日は、晴天なり。明日は、雨でしょう。"
+        if len(chunks) == 1
+        else True
+    )
+
+    # 空テキスト
+    assert chunker.chunk("", config) == []
+
+    # 読点がない場合 → 1チャンク
+    text = "区切りなし"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) == 1
+    assert chunks[0].text == "区切りなし"
+
+    # 中黒でも分割
+    text = "A・B・C"
+    chunks = chunker.chunk(text, config)
+    assert len(chunks) >= 1
+
+    # min_chars 未満はマージされる
+    config2 = ChunkConfig(strategy=ChunkStrategy.PAUSE_MARKERS, min_chars=3)
+    text = "a、b、c、d"
+    chunks = chunker.chunk(text, config2)
+    assert all(len(c.text) >= 3 for c in chunks)
+
+    # min_chars=0 (最小マージなし)
+    config3 = ChunkConfig(strategy=ChunkStrategy.PAUSE_MARKERS, min_chars=0)
+    text = "A、B、C"
+    chunks = chunker.chunk(text, config3)
+    # 読点区切りで各1文字 → min_chars=0なので分割される
+    assert chunks[0].text == "A"
+
+
+if __name__ == "__main__":
+    pytest.main([__file__])

tts_plugin_bridge-0.1.0/tests/test_factory.py

@@ -0,0 +1,66 @@
+from typing import AsyncIterator
+
+import pytest
+from tts_plugin_bridge.protocol import TTSConnector, TTSRequest, TTSResponse
+from tts_plugin_bridge.factory import ConnectorFactory
+
+
+class MockConnector(TTSConnector):
+    ENGINE_NAME = "mock"
+
+    async def synthesize(self, req: TTSRequest) -> TTSResponse:
+        return TTSResponse.ok(audio_data=b"mock")
+
+    async def synthesize_stream(self, req: TTSRequest) -> AsyncIterator[bytes]:
+        yield b"mock"
+
+    async def is_available(self) -> bool:
+        return True
+
+    async def close(self):
+        pass
+
+
+def test_factory_registration():
+    # Manually register for testing
+    ConnectorFactory._registry["mock"] = MockConnector
+
+    assert "mock" in ConnectorFactory.list_available()
+
+    connector = ConnectorFactory.create("mock")
+    assert isinstance(connector, MockConnector)
+    assert connector.name == "mock"
+
+
+def test_factory_not_found():
+    with pytest.raises(ValueError, match="Plugin 'invalid' not found"):
+        ConnectorFactory.create("invalid")
+
+
+def test_factory_case_insensitive():
+    ConnectorFactory._registry["mock"] = MockConnector
+    connector = ConnectorFactory.create("Mock")
+    assert isinstance(connector, MockConnector)
+
+
+def test_factory_duplicate_skip():
+    ConnectorFactory._registry.clear()
+    ConnectorFactory._discovered = False
+
+    # Register first
+    ConnectorFactory._registry["mock"] = MockConnector
+    # Register again — should warn but not raise
+    old_len = len(ConnectorFactory._registry)
+    ConnectorFactory._registry["mock"] = MockConnector
+    assert len(ConnectorFactory._registry) == old_len
+
+
+def test_factory_create_with_kwargs():
+    class ConnectorWithArgs(MockConnector):
+        def __init__(self, **kwargs):
+            self.received = kwargs
+
+    ConnectorFactory._registry["withargs"] = ConnectorWithArgs
+    conn = ConnectorFactory.create("withargs", server_url="http://test", timeout=10)
+    assert conn.received["server_url"] == "http://test"
+    assert conn.received["timeout"] == 10

tts_plugin_bridge-0.1.0/tests/test_protocol.py

@@ -0,0 +1,99 @@
+import pytest
+from pydantic import ValidationError
+from tts_plugin_bridge.protocol import (
+    TTSRequest,
+    TTSResponse,
+    ChunkConfig,
+    ChunkStrategy,
+)
+
+
+class TestTTSRequest:
+    def test_valid_defaults(self):
+        req = TTSRequest(text="Hello")
+        assert req.text == "Hello"
+        assert req.speed == 1.0
+        assert req.pitch is None
+        assert req.volume == 1.0
+        assert req.model is None
+        assert req.output_format == "wav"
+        assert req.chunk is False
+        assert req.chunk_config is None
+        assert req.extra == {}
+
+    def test_minimal_text(self):
+        req = TTSRequest(text="a")
+        assert req.text == "a"
+
+    def test_empty_text_raises(self):
+        with pytest.raises(ValidationError):
+            TTSRequest(text="")
+
+    def test_speed_at_boundaries(self):
+        # Lower boundary
+        req = TTSRequest(text="test", speed=0.1)
+        assert req.speed == 0.1
+        # Upper boundary
+        req = TTSRequest(text="test", speed=3.0)
+        assert req.speed == 3.0
+
+    def test_speed_below_minimum_raises(self):
+        with pytest.raises(ValidationError):
+            TTSRequest(text="test", speed=0.0)
+
+    def test_speed_above_maximum_raises(self):
+        with pytest.raises(ValidationError):
+            TTSRequest(text="test", speed=3.1)
+
+    def test_volume_at_boundaries(self):
+        req = TTSRequest(text="test", volume=0.0)
+        assert req.volume == 0.0
+        req = TTSRequest(text="test", volume=3.0)
+        assert req.volume == 3.0
+
+    def test_volume_negative_raises(self):
+        with pytest.raises(ValidationError):
+            TTSRequest(text="test", volume=-0.1)
+
+    def test_chunk_config_propagation(self):
+        config = ChunkConfig(strategy=ChunkStrategy.SENTENCE, max_chars=50)
+        req = TTSRequest(text="test", chunk=True, chunk_config=config)
+        assert req.chunk_config is config
+        assert req.chunk_config.strategy == ChunkStrategy.SENTENCE
+
+    def test_extra_params(self):
+        req = TTSRequest(text="test", extra={"style_id": 123, "custom": "val"})
+        assert req.extra["style_id"] == 123
+        assert req.extra["custom"] == "val"
+
+    def test_model_field(self):
+        req = TTSRequest(text="test", model="ja-JP-KeigoNeural")
+        assert req.model == "ja-JP-KeigoNeural"
+        assert "model" not in req.extra
+
+
+class TestTTSResponse:
+    def test_ok(self):
+        res = TTSResponse.ok(audio_data=b"dummy")
+        assert res.success is True
+        assert res.audio_data == b"dummy"
+        assert res.error is None
+
+    def test_ok_with_metadata(self):
+        res = TTSResponse.ok(
+            audio_data=b"data", duration_sec=2.5, metadata={"format": "wav"}
+        )
+        assert res.duration_sec == 2.5
+        assert res.metadata["format"] == "wav"
+
+    def test_fail(self):
+        res = TTSResponse.fail(error="Error message")
+        assert res.success is False
+        assert res.error == "Error message"
+        assert res.audio_data is None
+
+    def test_fail_with_metadata(self):
+        res = TTSResponse.fail(error="fail")
+        assert res.success is False
+        assert res.error == "fail"
+        assert res.audio_data is None

tts_plugin_bridge-0.1.0/tts_plugin_bridge/__init__.py

@@ -0,0 +1,4 @@
+from .protocol import TTSRequest, TTSResponse, TTSConnector
+from .factory import ConnectorFactory
+
+__all__ = ["TTSRequest", "TTSResponse", "TTSConnector", "ConnectorFactory"]

tts_plugin_bridge-0.1.0/tts_plugin_bridge/chunker.py

@@ -0,0 +1,133 @@
+import re
+from typing import List, Protocol
+from .protocol import ChunkResult, ChunkConfig
+
+
+class TextChunker(Protocol):
+    def chunk(self, text: str, config: ChunkConfig) -> List[ChunkResult]: ...
+
+
+class SentenceChunker:
+    """句点で分割"""
+
+    def chunk(self, text: str, config: ChunkConfig) -> List[ChunkResult]:
+        if not text:
+            return []
+
+        # 句点(。！？)を保持して分割するための正規表現
+        pattern = r"([。！？])"
+        parts = re.split(pattern, text)
+
+        combined_parts = []
+        for i in range(0, len(parts) - 1, 2):
+            combined_parts.append(parts[i] + parts[i + 1])
+
+        if len(parts) % 2 != 0 and parts[-1]:
+            combined_parts.append(parts[-1])
+
+        results = []
+        for idx, part in enumerate(combined_parts):
+            if part:
+                results.append(ChunkResult(text=part, index=idx, char_count=len(part)))
+        return results
+
+
+class CharacterCountChunker:
+    """文字数で分割"""
+
+    def chunk(self, text: str, config: ChunkConfig) -> List[ChunkResult]:
+        if not text:
+            return []
+
+        max_chars = config.max_chars
+        results = []
+
+        for i in range(0, len(text), max_chars):
+            chunk_text = text[i : i + max_chars]
+            results.append(
+                ChunkResult(
+                    text=chunk_text, index=len(results), char_count=len(chunk_text)
+                )
+            )
+        return results
+
+
+class HybridChunker:
+    """原則sentence分割、max_chars超えりでchar分割"""
+
+    def __init__(self):
+        self.sentence_chunker = SentenceChunker()
+        self.char_chunker = CharacterCountChunker()
+
+    def chunk(self, text: str, config: ChunkConfig) -> List[ChunkResult]:
+        if not text:
+            return []
+
+        sentence_chunks = self.sentence_chunker.chunk(text, config)
+
+        final_results = []
+        current_index = 0
+
+        for s_chunk in sentence_chunks:
+            if len(s_chunk.text) <= config.max_chars:
+                final_results.append(
+                    ChunkResult(
+                        text=s_chunk.text,
+                        index=current_index,
+                        char_count=s_chunk.char_count,
+                        is_partial=False,
+                    )
+                )
+                current_index += 1
+            else:
+                sub_chunks = self.char_chunker.chunk(s_chunk.text, config)
+
+                for i, sub in enumerate(sub_chunks):
+                    is_last = i == len(sub_chunks) - 1
+                    final_results.append(
+                        ChunkResult(
+                            text=sub.text,
+                            index=current_index,
+                            char_count=sub.char_count,
+                            is_partial=not is_last,
+                            original_sentence=s_chunk.text,
+                        )
+                    )
+                    current_index += 1
+
+        return final_results
+
+
+class PauseMarkerChunker:
+    def chunk(self, text: str, config: ChunkConfig) -> List[ChunkResult]:
+        if not text:
+            return []
+
+        _split_re = re.compile(r"[、，・,; 　]+")
+        parts = _split_re.split(text)
+        parts = [p.strip() for p in parts if p.strip()]
+        if not parts:
+            return [ChunkResult(text=text, index=0, char_count=len(text))]
+
+        merged: list[str] = []
+        for p in parts:
+            if merged and len(merged[-1]) < config.min_chars:
+                merged[-1] += p
+            else:
+                merged.append(p)
+
+        if merged and len(merged) > 1 and len(merged[-1]) < config.min_chars:
+            tail = merged.pop()
+            merged[-1] += tail
+
+        results = []
+        for idx, chunk in enumerate(merged):
+            results.append(
+                ChunkResult(
+                    text=chunk,
+                    index=idx,
+                    char_count=len(chunk),
+                    is_partial=(idx < len(merged) - 1),
+                )
+            )
+        return results

tts_plugin_bridge-0.1.0/tts_plugin_bridge/factory.py

@@ -0,0 +1,48 @@
+import importlib.metadata
+from typing import Type, Dict
+from .protocol import TTSConnector
+
+
+class ConnectorFactory:
+    _registry: Dict[str, Type[TTSConnector]] = {}
+    _discovered = False
+
+    @classmethod
+    def _discover(cls) -> None:
+        if cls._discovered:
+            return
+
+        eps = importlib.metadata.entry_points(group="tts_bridge.connectors")
+
+        for ep in eps:
+            try:
+                connector_cls = ep.load()
+                name = getattr(connector_cls, "ENGINE_NAME", ep.name)
+                if name in cls._registry:
+                    print(
+                        f"⚠️ Warning: Connector '{name}' already registered. Skipping {ep.value}"
+                    )
+                    continue
+                cls._registry[name] = connector_cls
+            except Exception as e:
+                print(f"❌ Failed to load plugin {ep.value}: {e}")
+
+        cls._discovered = True
+
+    @classmethod
+    def list_available(cls) -> list[str]:
+        cls._discover()
+        return list(cls._registry.keys())
+
+    @classmethod
+    def create(cls, engine: str, **kwargs) -> TTSConnector:
+        cls._discover()
+        connector_cls = cls._registry.get(engine.lower())
+        if not connector_cls:
+            available = ", ".join(cls.list_available()) or "none"
+            raise ValueError(
+                f"TTS Plugin '{engine}' not found. \n"
+                f"Available engines: {available}\n"
+                f"💡 To install, run: uv add tts-plugin-{engine}"
+            )
+        return connector_cls(**kwargs)

tts_plugin_bridge-0.1.0/tts_plugin_bridge/protocol.py

@@ -0,0 +1,104 @@
+from abc import ABC, abstractmethod
+from typing import AsyncIterator, ClassVar, Optional
+from pydantic import BaseModel, Field
+from dataclasses import dataclass
+from enum import Enum
+
+
+class ChunkStrategy(Enum):
+    SENTENCE = "sentence"  # 句点(。！？)で分割
+    CHARACTER_COUNT = "char"  # 文字数で分割
+    HYBRID = "hybrid"  # 原則sentence、max_chars超えりでchar分割
+    PAUSE_MARKERS = "pause"  # 「、」など一時停止マーカーで分割
+
+
+@dataclass
+class ChunkConfig:
+    strategy: ChunkStrategy = ChunkStrategy.HYBRID
+    max_chars: int = 100  # HYBRID/CHARACTER_COUNT時
+    max_duration_sec: float = 30.0  # 目標最長時間
+    min_chars: int = 10  # 最小文字数（短すぎる分割を防ぐ）
+    preserve_punctuation: bool = True  # 句読点を保持するか
+
+
+@dataclass
+class ChunkResult:
+    """分割されたテキストの情報を保持するクラス"""
+
+    text: str
+    index: int
+    char_count: int
+    is_partial: bool = False  # 文の途中での分割
+    original_sentence: str = ""  # 分割元の文（HYBRID時）
+
+
+class TTSRequest(BaseModel):
+    """全エンジン共通のリクエストモデル"""
+
+    text: str = Field(..., min_length=1, description="合成テキスト")
+    speed: float = Field(
+        default=1.0, ge=0.1, le=3.0, description="話速: 1.0=標準, >1.0=速い"
+    )
+    pitch: Optional[float] = Field(
+        default=None, description="ピッチ補正（エンジン依存）"
+    )
+    volume: Optional[float] = Field(default=1.0, ge=0.0, le=3.0, description="音量倍率")
+    model: Optional[str] = Field(default=None, description="エンジン固有モデル名")
+    output_format: str = Field(default="wav", description="出力フォーマット")
+    chunk: bool = Field(default=False, description="テキスト分割を有効にするか")
+    chunk_config: Optional[ChunkConfig] = Field(default=None, description="分割の設定")
+    extra: dict = Field(default_factory=dict, description="エンジン固有パラメータ")
+
+
+class TTSResponse(BaseModel):
+    """全エンジン共通のレスポンスモデル"""
+
+    success: bool
+    audio_data: Optional[bytes] = None
+    file_path: Optional[str] = None
+    duration_sec: Optional[float] = None
+    error: Optional[str] = None
+    metadata: dict = Field(default_factory=dict)
+
+    @classmethod
+    def ok(cls, audio_data: bytes, **kwargs) -> "TTSResponse":
+        return cls(success=True, audio_data=audio_data, **kwargs)
+
+    @classmethod
+    def fail(cls, error: str, **kwargs) -> "TTSResponse":
+        return cls(success=False, error=error, **kwargs)
+
+
+class TTSConnector(ABC):
+    """TTSエンジン共通インターフェース"""
+
+    ENGINE_NAME: ClassVar[str] = "unknown"
+    SUPPORTED_PARAMS: ClassVar[list[str]] = []
+
+    @property
+    def name(self) -> str:
+        return self.ENGINE_NAME
+
+    @abstractmethod
+    async def synthesize(self, req: TTSRequest) -> TTSResponse:
+        """音声合成を実行"""
+        pass
+
+    @abstractmethod
+    async def synthesize_stream(self, req: TTSRequest) -> AsyncIterator[bytes]:
+        """音声合成をストリーミング形式で実行（チャンク単位で bytes を逐次返す）"""
+        if False:
+            yield b""
+
+    @abstractmethod
+    async def is_available(self) -> bool:
+        """エンジンサーバーが利用可能かチェック"""
+        pass
+
+    def get_supported_params(self) -> list[str]:
+        return self.SUPPORTED_PARAMS.copy()
+
+    @abstractmethod
+    async def close(self):
+        """リソースを解放"""
+        pass