voicerender 0.2.2__tar.gz → 0.2.3__tar.gz

{voicerender-0.2.2 → voicerender-0.2.3}/.github/workflows/tests.yml

@@ -197,6 +197,7 @@ jobs:
                   ):
                       base_requirements.add(requirement.name.lower())
               engine_sdks = {
+                  "chatterboxsynth",
                   "inflectsynth", "kittensynth", "pykokoro", "pipersynth",
                   "pocketsynth", "soprosynth", "supertonicsynth",
                   "qwen3synth",
@@ -235,6 +236,7 @@ jobs:
           assert resources.files("voicerender").joinpath("book_layout.py").is_file()
           assert RenderPlanSet is not None
           assert {item["id"] for item in list_engines()} == {
+              "chatterbox",
               "inflect",
               "kitten",
               "kokoro",
@@ -246,6 +248,7 @@ jobs:
           }
           assert not any(
               name.split(".", 1)[0] in {
+                  "chatterboxsynth",
                   "inflectsynth", "kittensynth", "pykokoro", "pipersynth",
                   "pocketsynth", "soprosynth", "supertonicsynth", "utterplan",
                   "qwen3synth",

{voicerender-0.2.2 → voicerender-0.2.3}/.ledger/releaseledger/data/ledgers/main/events/events.jsonl

@@ -28,3 +28,8 @@
 {"data":{"updated_rows":4},"event":"audit.updated","event_id":"event-0028","record_revisions":{"commit_audit_sheet":2},"release_version":"0.2.2","schema_version":2}
 {"data":{"entry_ids":["entry-0001","entry-0002","entry-0003","entry-0004"],"synced_audit_rows":4},"event":"entry.batch_added","event_id":"event-0029","record_revisions":{"commit_audit_sheet":3,"entry:0.2.2/entry-0001":1,"entry:0.2.2/entry-0002":1,"entry:0.2.2/entry-0003":1,"entry:0.2.2/entry-0004":1,"release:0.2.2":3},"release_version":"0.2.2","schema_version":2}
 {"data":{"released_at":"2026-10-17"},"event":"release.finalized","event_id":"event-0030","record_revisions":{"release:0.2.2":4},"release_version":"0.2.2","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0031","record_revisions":{"release:0.2.3":1},"release_version":"0.2.3","schema_version":2}
+{"data":{"fields":["git_base_ref","git_base_sha","git_commit_count","git_head_ref","git_head_sha","git_range"]},"event":"release.updated","event_id":"event-0032","record_revisions":{"release:0.2.3":2},"release_version":"0.2.3","schema_version":2}
+{"data":{"row_count":2},"event":"audit.created","event_id":"event-0033","record_revisions":{"commit_audit_sheet":1},"release_version":"0.2.3","schema_version":2}
+{"data":{"updated_rows":2},"event":"audit.updated","event_id":"event-0034","record_revisions":{"commit_audit_sheet":2},"release_version":"0.2.3","schema_version":2}
+{"data":{"entry_ids":["entry-0001","entry-0002"],"synced_audit_rows":2},"event":"entry.batch_added","event_id":"event-0035","record_revisions":{"commit_audit_sheet":3,"entry:0.2.3/entry-0001":1,"entry:0.2.3/entry-0002":1,"release:0.2.3":3},"release_version":"0.2.3","schema_version":2}

voicerender-0.2.3/.ledger/releaseledger/data/ledgers/main/releases/0.2.3/audit/commit-audit.yaml

@@ -0,0 +1,74 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: 0.2.3
+git_base_ref: v0.2.2
+git_base_sha: aecc0461fdecf55f60f20991e796efd1c240679a
+git_head_ref: HEAD
+git_head_sha: b17f1a9010849b0e6aec846f222e12a86f04ad79
+git_range: aecc0461fdecf55f60f20991e796efd1c240679a..b17f1a9010849b0e6aec846f222e12a86f04ad79
+commit_count: 2
+rows:
+  - sha: 67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+    source_ref: git:67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+    short_sha: 67e4d8e
+    changed_paths:
+      - pyproject.toml
+      - tests/test_kittensynth_engine.py
+      - tests/test_preflight.py
+      - voicerender/engines/kittensynth.py
+    stats:
+      files_changed: 4
+      insertions: 73
+      deletions: 1
+    inspected: true
+    inspected_paths:
+      - pyproject.toml
+      - tests/test_kittensynth_engine.py
+      - tests/test_preflight.py
+      - voicerender/engines/kittensynth.py
+    observed_behavior:
+      Preflight now classifies managed model dependency failures as
+      non-replanable runtime rejects, preserving native error context instead of treating
+      the failure as a text-capacity issue; the KittenSynth optional dependency floor
+      is raised to 0.1.6.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: raise kittensynth floor"
+    target_entry_id: entry-0001
+    notes: ""
+  - sha: b17f1a9010849b0e6aec846f222e12a86f04ad79
+    source_ref: git:b17f1a9010849b0e6aec846f222e12a86f04ad79
+    short_sha: b17f1a9
+    changed_paths:
+      - README.md
+      - pyproject.toml
+      - tests/test_chatterboxsynth_engine.py
+      - tests/test_engine_registry.py
+      - voicerender/engines/chatterboxsynth.py
+      - voicerender/engines/registry.py
+    stats:
+      files_changed: 6
+      insertions: 1672
+      deletions: 7
+    inspected: true
+    inspected_paths:
+      - README.md
+      - pyproject.toml
+      - tests/test_chatterboxsynth_engine.py
+      - tests/test_engine_registry.py
+      - voicerender/engines/chatterboxsynth.py
+      - voicerender/engines/registry.py
+    observed_behavior:
+      Adds optional English-only ChatterboxSynth rendering with installed-model
+      discovery, pinned local or managed reference voices, exact preflight measurement,
+      and lazy voice preparation.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: add chatterbox"
+    target_entry_id: entry-0002
+    notes: ""

voicerender-0.2.3/.ledger/releaseledger/data/ledgers/main/releases/0.2.3/entries/entry-0001.md

@@ -0,0 +1,32 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: 0.2.3
+kind: changed
+summary:
+  Changed preflight handling so unavailable managed KittenSynth dependencies
+  reject without scheduling a replan
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+paths:
+  - pyproject.toml
+  - tests/test_kittensynth_engine.py
+  - tests/test_preflight.py
+  - voicerender/engines/kittensynth.py
+issues: []
+prs: []
+sources:
+  - git:67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---

voicerender-0.2.3/.ledger/releaseledger/data/ledgers/main/releases/0.2.3/entries/entry-0002.md

@@ -0,0 +1,34 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0002
+release_version: 0.2.3
+kind: added
+summary:
+  Added optional ChatterboxSynth rendering with pinned reference voices and
+  installed-model discovery
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:b17f1a9010849b0e6aec846f222e12a86f04ad79
+paths:
+  - README.md
+  - pyproject.toml
+  - tests/test_chatterboxsynth_engine.py
+  - tests/test_engine_registry.py
+  - voicerender/engines/chatterboxsynth.py
+  - voicerender/engines/registry.py
+issues: []
+prs: []
+sources:
+  - git:b17f1a9010849b0e6aec846f222e12a86f04ad79
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 2
+---

voicerender-0.2.3/.ledger/releaseledger/data/ledgers/main/releases/0.2.3/release.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 3
+version: 0.2.3
+status: planned
+history_state: curated
+title: null
+released_at: null
+previous_version: 0.2.2
+cancel_reason: null
+superseded_by: null
+changelog_file: null
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 2
+artifact_count: 0
+git_base_ref: v0.2.2
+git_base_sha: aecc0461fdecf55f60f20991e796efd1c240679a
+git_head_ref: HEAD
+git_head_sha: b17f1a9010849b0e6aec846f222e12a86f04ad79
+git_range: aecc0461fdecf55f60f20991e796efd1c240679a..b17f1a9010849b0e6aec846f222e12a86f04ad79
+git_commit_count: 2
+---

voicerender-0.2.3/.ledger/releaseledger/work/0.2.3/audit-decisions.yaml

@@ -0,0 +1,31 @@
+rows:
+  - sha: 67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+    inspected: true
+    inspected_paths:
+      - pyproject.toml
+      - tests/test_kittensynth_engine.py
+      - tests/test_preflight.py
+      - voicerender/engines/kittensynth.py
+    observed_behavior: Preflight now classifies managed model dependency failures as non-replanable runtime rejects, preserving native error context instead of treating the failure as a text-capacity issue; the KittenSynth optional dependency floor is raised to 0.1.6.
+    public_impact: public
+    decision: accepted
+    target_entry_key: null
+    target_entry_id: null
+    notes: ""
+    stale: false
+  - sha: b17f1a9010849b0e6aec846f222e12a86f04ad79
+    inspected: true
+    inspected_paths:
+      - README.md
+      - pyproject.toml
+      - tests/test_chatterboxsynth_engine.py
+      - tests/test_engine_registry.py
+      - voicerender/engines/chatterboxsynth.py
+      - voicerender/engines/registry.py
+    observed_behavior: Adds optional English-only ChatterboxSynth rendering with installed-model discovery, pinned local or managed reference voices, exact preflight measurement, and lazy voice preparation.
+    public_impact: public
+    decision: accepted
+    target_entry_key: null
+    target_entry_id: null
+    notes: ""
+    stale: false

voicerender-0.2.3/.ledger/releaseledger/work/0.2.3/audit.yaml

@@ -0,0 +1,53 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 1
+release_version: 0.2.3
+git_base_ref: v0.2.2
+git_base_sha: aecc0461fdecf55f60f20991e796efd1c240679a
+git_head_ref: HEAD
+git_head_sha: b17f1a9010849b0e6aec846f222e12a86f04ad79
+git_range: aecc0461fdecf55f60f20991e796efd1c240679a..b17f1a9010849b0e6aec846f222e12a86f04ad79
+commit_count: 2
+rows:
+  - sha: 67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+    source_ref: git:67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+    short_sha: 67e4d8e
+    changed_paths:
+      - pyproject.toml
+      - tests/test_kittensynth_engine.py
+      - tests/test_preflight.py
+      - voicerender/engines/kittensynth.py
+    stats:
+      files_changed: 4
+      insertions: 73
+      deletions: 1
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "feat: raise kittensynth floor"
+  - sha: b17f1a9010849b0e6aec846f222e12a86f04ad79
+    source_ref: git:b17f1a9010849b0e6aec846f222e12a86f04ad79
+    short_sha: b17f1a9
+    changed_paths:
+      - README.md
+      - pyproject.toml
+      - tests/test_chatterboxsynth_engine.py
+      - tests/test_engine_registry.py
+      - voicerender/engines/chatterboxsynth.py
+      - voicerender/engines/registry.py
+    stats:
+      files_changed: 6
+      insertions: 1672
+      deletions: 7
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "feat: add chatterbox"

voicerender-0.2.3/.ledger/releaseledger/work/0.2.3/entries.yaml

@@ -0,0 +1,45 @@
+schema: releaseledger.entry-batch.v1
+operation: create
+schema_version: 1
+object_type: release_entry_batch
+release_version: 0.2.3
+git_base_ref: aecc0461fdecf55f60f20991e796efd1c240679a
+git_base_sha: aecc0461fdecf55f60f20991e796efd1c240679a
+git_head_ref: b17f1a9010849b0e6aec846f222e12a86f04ad79
+git_head_sha: b17f1a9010849b0e6aec846f222e12a86f04ad79
+include_merges: nontrivial
+entries:
+  - kind: changed
+    summary: Changed preflight handling so unavailable managed KittenSynth dependencies reject without scheduling a replan
+    status: accepted
+    source_refs:
+      - git:67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+    paths:
+      - pyproject.toml
+      - tests/test_kittensynth_engine.py
+      - tests/test_preflight.py
+      - voicerender/engines/kittensynth.py
+    sources:
+      - git:67e4d8ec44e04f96d7041afa8c87c762bec87b6f
+    prs: []
+    issues: []
+    contributors:
+      - "@holgern"
+  - kind: added
+    summary: Added optional ChatterboxSynth rendering with pinned reference voices and installed-model discovery
+    status: accepted
+    source_refs:
+      - git:b17f1a9010849b0e6aec846f222e12a86f04ad79
+    paths:
+      - README.md
+      - pyproject.toml
+      - tests/test_chatterboxsynth_engine.py
+      - tests/test_engine_registry.py
+      - voicerender/engines/chatterboxsynth.py
+      - voicerender/engines/registry.py
+    sources:
+      - git:b17f1a9010849b0e6aec846f222e12a86f04ad79
+    prs: []
+    issues: []
+    contributors:
+      - "@holgern"

voicerender-0.2.3/.ledger/releaseledger/work/0.2.3/evidence/67e4d8e.patch

@@ -0,0 +1,145 @@
+ pyproject.toml                     |  2 +-
+ tests/test_kittensynth_engine.py   | 30 ++++++++++++++++++++++++++++++
+ tests/test_preflight.py            | 37 +++++++++++++++++++++++++++++++++++++
+ voicerender/engines/kittensynth.py |  5 +++++
+ 4 files changed, 73 insertions(+), 1 deletion(-)
+
+diff --git a/pyproject.toml b/pyproject.toml
+index 5aa5811..17b50ff 100644
+--- a/pyproject.toml
++++ b/pyproject.toml
+@@ -21,7 +21,7 @@ dependencies = [
+
+ [project.optional-dependencies]
+ inflect = ["inflectsynth[cpu]>=0.1.1,<0.2"]
+-kitten = ["kittensynth[cpu]>=0.1.4,<0.2"]
++kitten = ["kittensynth[cpu]>=0.1.6,<0.2"]
+ kokoro = ["pykokoro>=0.10.5,<0.11"]
+ piper = ["pipersynth>=0.2.5,<0.3"]
+ pocket = ["pocketsynth[cpu]>=0.2.5,<0.3"]
+diff --git a/tests/test_kittensynth_engine.py b/tests/test_kittensynth_engine.py
+index 8c437ec..9fb2279 100644
+--- a/tests/test_kittensynth_engine.py
++++ b/tests/test_kittensynth_engine.py
+@@ -301,6 +301,36 @@ def test_synthesis_too_long_error_translates_with_replan_details(
+     assert outcome.measurement.maximum == 512
+
+
++def test_managed_dependency_error_is_a_non_replanable_runtime_reject(
++    monkeypatch: pytest.MonkeyPatch,
++) -> None:
++    module = ModuleType("kittensynth")
++    native_error_type = type("ManagedModelDependencyError", (Exception,), {})
++    module.ManagedModelDependencyError = native_error_type  # type: ignore[attr-defined]
++    native_error = native_error_type("managed download transport unavailable")
++
++    class FailingKittenVoice:
++        @classmethod
++        def from_pretrained(cls, *args: Any, **kwargs: Any) -> Any:
++            raise native_error
++
++    module.KittenVoice = FailingKittenVoice  # type: ignore[attr-defined]
++    monkeypatch.setitem(sys.modules, "kittensynth", module)
++    selection = EngineSelection(
++        engine="kitten",
++        target_id="nano-0.8-int8",
++        language="en-US",
++        voice="Jasper",
++    )
++
++    with pytest.raises(EngineBackendError) as caught:
++        KittenSynthEngineAdapter().open(selection)
++
++    assert caught.value.code == "kitten.runtime_dependency_error"
++    assert caught.value.native_error_type == "ManagedModelDependencyError"
++    assert classify_measurement(caught.value).disposition is PreflightDisposition.REJECT
++
++
+ def _synthesis_result(audio: Any) -> SimpleNamespace:
+     return SimpleNamespace(
+         audio=audio,
+diff --git a/tests/test_preflight.py b/tests/test_preflight.py
+index 3303c9e..1fde38b 100644
+--- a/tests/test_preflight.py
++++ b/tests/test_preflight.py
+@@ -281,6 +281,7 @@ def _install_fake_kittensynth(
+     amount: int,
+     maximum: int | None,
+     fits: bool | None,
++    open_error: Exception | None = None,
+ ) -> list[tuple[str, Any]]:
+     events: list[tuple[str, Any]] = []
+     model = SimpleNamespace(
+@@ -310,6 +311,9 @@ def _install_fake_kittensynth(
+         @classmethod
+         def from_pretrained(cls, target_id: str, **kwargs: Any) -> FakeVoice:
+             assert target_id == "kitten-test-model"
++            if open_error is not None:
++                events.append(("open", target_id))
++                raise open_error
+             return cls()
+
+         def measure_prepared(self, text: str) -> Any:
+@@ -341,6 +345,8 @@ def _install_fake_kittensynth(
+         "measurement_metric": "model_tokens",
+     }
+     module.KittenVoice = FakeVoice
++    if open_error is not None:
++        module.ManagedModelDependencyError = type(open_error)  # type: ignore[attr-defined]
+     module.SynthesisMeasure = object
+     module.SynthesisConfig = object
+     module.SynthesisResult = object
+@@ -521,6 +527,37 @@ def test_kitten_preflight_uses_exact_frontend_measurement_without_synthesis(
+     assert events[0][1] == "Kitten preflight"
+
+
++def test_kitten_managed_dependency_error_rejects_preflight_before_measurement(
++    monkeypatch: pytest.MonkeyPatch, tmp_path: Path
++) -> None:
++    native_error_type = type("ManagedModelDependencyError", (Exception,), {})
++    native_error = native_error_type("managed download transport unavailable")
++    events = _install_fake_kittensynth(
++        monkeypatch,
++        amount=180,
++        maximum=256,
++        fits=True,
++        open_error=native_error,
++    )
++    binding = {
++        "renderer": "kitten",
++        "target_id": "kitten-test-model",
++        "voice": "Jasper",
++    }
++    plan = _plan(
++        ("Kitten preflight dependency failure", True, "sentence"), binding=binding
++    )
++
++    report = preflight_render_plan(plan, tmp_path / "kitten-dependency-error.toml")
++
++    check = report.checks[0]
++    assert report.status == "reject"
++    assert check.status == "error"
++    assert check.source == "kitten.runtime_dependency_error"
++    assert report.replan == ()
++    assert [event[0] for event in events] == ["open"]
++
++
+ def test_kitten_preflight_defers_emphasis_to_composition(
+     monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+ ) -> None:
+diff --git a/voicerender/engines/kittensynth.py b/voicerender/engines/kittensynth.py
+index 9383225..cb87622 100644
+--- a/voicerender/engines/kittensynth.py
++++ b/voicerender/engines/kittensynth.py
+@@ -171,6 +171,11 @@ def _translate_kitten_error(
+         ("InvalidSpeedError", InvalidEngineOptionError, "kitten.invalid_speed"),
+         ("InvalidVoiceError", InvalidEngineVoiceError, "kitten.voice_unavailable"),
+         ("UnsupportedModelError", InvalidEngineModelError, "kitten.model_unsupported"),
++        (
++            "ManagedModelDependencyError",
++            EngineBackendError,
++            "kitten.runtime_dependency_error",
++        ),
+         ("OnnxVoiceContractError", EngineBackendError, "kitten.runtime_contract_error"),
+     )
+     error_type: type[EngineError] = EngineBackendError