feat: add peer-bound typed Voice client and owned sessions

.github/workflows/release.yml

@@ -3,9 +3,19 @@ on:
   workflow_dispatch:
     inputs:
       tag:
-        description: Existing version tag (vX.Y.Z) committed through a reviewed PR
+        description: Existing version tag for the immutable module release
         type: string
         required: true
+      release_mode:
+        description: Use the ordinary main path or reviewed-epic release admission
+        type: choice
+        options: [main, reviewed-epic]
+        default: main
+        required: true
+      reviewed_pr:
+        description: Positive canonical PR number whose merge commit the tag names (reviewed-epic mode only)
+        type: number
+        required: false
   push:
     tags: ['v*']
 permissions: {}
@@ -18,11 +28,15 @@ jobs:
     outputs:
       tag: ${{ steps.tag.outputs.tag }}
       version: ${{ steps.tag.outputs.version }}
+      release_mode: ${{ steps.tag.outputs.release_mode }}
+      reviewed_pr: ${{ steps.tag.outputs.reviewed_pr }}
     steps:
       - id: tag
         shell: bash
         env:
           TAG: ${{ github.event_name == 'push' && github.ref_name || inputs.tag }}
+          RELEASE_MODE: ${{ github.event_name == 'push' && 'main' || inputs.release_mode }}
+          REVIEWED_PR: ${{ inputs.reviewed_pr }}
         run: |
           set -euo pipefail
           [[ "$TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+([+-][0-9A-Za-z.-]+)?$ ]] || {
@@ -31,14 +45,49 @@ jobs:
           }
           echo "tag=$TAG" >> "$GITHUB_OUTPUT"
           echo "version=${TAG#v}" >> "$GITHUB_OUTPUT"
+          [[ "$RELEASE_MODE" == main || "$RELEASE_MODE" == reviewed-epic ]] || {
+            echo "release_mode must be main or reviewed-epic" >&2
+            exit 2
+          }
+          if [[ "$RELEASE_MODE" == reviewed-epic ]]; then
+            [[ "$REVIEWED_PR" =~ ^[1-9][0-9]*$ ]] || {
+              echo "reviewed_pr must be a positive integer in reviewed-epic mode" >&2
+              exit 2
+            }
+          else
+            [[ -z "$REVIEWED_PR" || "$REVIEWED_PR" == 0 ]] || {
+              echo "reviewed_pr is only valid in reviewed-epic mode" >&2
+              exit 2
+            }
+            REVIEWED_PR=""
+          fi
+          {
+            echo "release_mode=$RELEASE_MODE"
+            # The reusable workflow input is numeric; zero is the ordinary-path sentinel.
+            echo "reviewed_pr=${REVIEWED_PR:-0}"
+          } >> "$GITHUB_OUTPUT"
   module-release:
     needs: resolve
+    if: needs.resolve.outputs.release_mode == 'main'
     permissions:
       contents: write
-    uses: tinyhumansai/.github/.github/workflows/module-release.yml@4adc1080fb495098e7af1aade82ed7e6e3c69bb7
+    uses: tinyhumansai/.github/.github/workflows/module-release.yml@1e28317c435a9c714002199e65d18a1067fa5777
     with:
       tag: ${{ needs.resolve.outputs.tag }}
       version: ${{ needs.resolve.outputs.version }}
       module-crate: tinyvoice-module
       apt-packages: libasound2-dev libx11-dev libxtst-dev libxi-dev
       module-manifest: crates/tinyvoice-module/Cargo.toml
+  module-reviewed-epic-release:
+    needs: resolve
+    if: needs.resolve.outputs.release_mode == 'reviewed-epic'
+    permissions:
+      contents: write
+      pull-requests: read
+      checks: read
+      actions: read
+    uses: tinyhumansai/.github/.github/workflows/module-reviewed-epic-release.yml@1e28317c435a9c714002199e65d18a1067fa5777
+    with:
+      tag: ${{ needs.resolve.outputs.tag }}
+      version: ${{ needs.resolve.outputs.version }}
+      reviewed-pr: ${{ fromJSON(needs.resolve.outputs.reviewed_pr || '0') }}

Cargo.toml

@@ -3,8 +3,8 @@ resolver = "3"
 # Every package lives under `crates/`. The loadable module is a nested
 # workspace because the vendored TinyBus manifests inherit their own workspace
 # metadata; build it through its own manifest.
-members = ["crates/tinyvoice", "crates/tinyvoice-bus"]
-default-members = ["crates/tinyvoice", "crates/tinyvoice-bus"]
+members = ["crates/tinyvoice", "crates/tinyvoice-bus", "crates/tinyvoice-client"]
+default-members = ["crates/tinyvoice", "crates/tinyvoice-bus", "crates/tinyvoice-client"]
 exclude = ["crates/tinyvoice-module", "vendor", "worktrees"]
 
 # Lints apply to the whole crate and to every target. CI runs clippy with

README.md

@@ -8,6 +8,7 @@ Ships two things from one repository:
 | --- | --- | --- |
 | `tinyvoice` (`crates/`) | `rlib` | A host that links the logic in-process |
 | `tinyvoice-bus` (`crates/`) | `rlib` | A host that only needs TinyBus names and value types |
+| `tinyvoice-client` (`crates/`) | `rlib` | A typed TinyBus client for the loadable TinyVoice module |
 | `tinyvoice-module` (`crates/`) | `cdylib` | A host that loads it over the TinyBus module ABI |
 
 ## What belongs here, and what does not

crates/tinyvoice-client/Cargo.toml

@@ -0,0 +1,29 @@
+[package]
+name = "tinyvoice-client"
+version = "0.1.0"
+edition = "2024"
+rust-version = "1.88"
+license = "GPL-3.0-only"
+description = "Typed TinyBus host client for the TinyVoice module."
+repository = "https://github.com/tinyhumansai/tinyvoice"
+
+[dependencies]
+# The contract carries audio samples as base64 text.
+base64 = "0.22"
+# TinyBus serializes contract values and deserializes their replies.
+serde = "1"
+# The module's transforms and stateful replies are inner JSON strings.
+serde_json = "1"
+# Shared TinyVoice member names, request types, and typed replies.
+tinyvoice-bus = { version = "0.1.4", path = "../tinyvoice-bus" }
+# TinyBus 0.3.2 adds ordinary peer-pinned clients for stateful voice leases.
+tinybus = { version = ">=0.3.2, <0.4", path = "../../vendor/tinybus/crates/tinybus", default-features = false }
+
+[dev-dependencies]
+# Implements the async in-memory service used by the broker tests.
+async-trait = "0.1"
+# Provides the async test executor and `#[tokio::test]` macro.
+tokio = { version = "1", features = ["macros", "rt-multi-thread", "time", "test-util"] }
+
+[lints]
+workspace = true