Skip to content

feat(spatius): forward avatar session extra params, update spatius to 1.0.5 - #2286

Open
3DRX wants to merge 1 commit into
TEN-framework:mainfrom
spatius-ai:feat/spatius-extra-params
Open

feat(spatius): forward avatar session extra params, update spatius to 1.0.5#2286
3DRX wants to merge 1 commit into
TEN-framework:mainfrom
spatius-ai:feat/spatius-extra-params

Conversation

@3DRX

@3DRX 3DRX commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Bump the spatius[opus] dependency from 1.0.4 to 1.0.5 and add extra_params to the extension config, forwarding it to the Spatius SDK's new_avatar_session so callers can pass server-side session options (e.g. server_post_process) through the extension. The dict is copied in update_params() and again at session creation to avoid aliasing caller/config state.
  • extra_params is exposed as an open object in the manifest property schema (params.extra_params) and defaults to {} in property.json.
  • Bump extension version to 0.2.5.

Region default change

spatius 1.0.5 changes the default ingress region behavior: when no region is specified, it is no longer fixed to us-west — the SDK resolves the region automatically via the Spatius global bootstrap API (automatic regional scheduling). If bootstrap resolution fails, it falls back to the last cached region or us-west.

The extension only passes region to the SDK when explicitly configured, so the new auto behavior is picked up with no additional code; the config log now reports region=(auto) when unset. Set params.region (e.g. us-west) to pin a concrete region.

Tests

  • Added tests/test_config.py covering the extra_params copy semantics and empty-default behavior.

Example

{
  "params": {
    "spatius_api_key": "${env:SPATIUS_API_KEY|}",
    "spatius_app_id": "${env:SPATIUS_APP_ID|}",
    "spatius_avatar_id": "...",
    "extra_params": {
      "server_post_process": "false"
    }
  }
}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant