Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Upgrade
spatius[opus]from 1.0.4 to 1.1.1 and exposeparams.extra_paramsso callers can pass server session options such as
{"server_post_process": "false"}to the SDK. Copy these options duringconfiguration normalization and session creation to isolate caller state.
The manifest exposes
params.extra_paramsas an object with an empty default.Automatic region selection now appears in connection-success logs and the
existing
vendor_metadata.regionfield using the SDK session's resolved region.The requested configuration stays intact, and disconnect clears session-specific
reporting. Explicitly configured regions continue to work.
The SDK upgrade includes automatic region selection and caching, shared TLS setup,
initialization telemetry, and separate 10-second session-token request and
WebSocket server-confirmation timeouts. Preserve the extension's 24 kHz Ogg Opus
default, explicit 30-minute token expiry, Agora egress, and TEN lifecycle. Optional
prewarming and token prefetching are not enabled.
Set the extension version to 0.2.5.
Validation
Validated with Python 3.10.12 and Spatius 1.1.1 in a disposable container using
ghcr.io/ten-framework/ten_agent_build:0.7.14:task test-extension EXTENSION=agents/ten_packages/extension/spatius_avatar_python:18 passed, including 14 new parameterized session regression cases.
operations. Coverage includes automatic/pinned regions, Agora configuration,
Opus/PCM and expiry settings, defensive copying, resolved-region reporting and
cleanup, audio/EOF/interruption/shutdown, and startup error propagation without
launching the audio processing task.
task check: passed, 1,432 Python files unchanged by Black.task lint-extension EXTENSION=spatius_avatar_python: passed, 10.00/10.git diff --check, Python syntax, JSON manifests, version and dependencyconsistency checks: passed.
task lint: failed on unrelated extensions, with no Spatiusdiagnostics. The environment lacks other vendors' dependencies, and
smallest_tts_pythonreferences a missingten_ai_base.utils.redact_headersmember. The full repository lint gate is not claimed as passing.
Live Spatius/Agora playback was not exercised. A supplemental
pip checkreportsthe development image's existing
pygobjectdependency on missingpycairo.