fix(aws): fix BedrockRuntimeClient/Config import errors in realtime p…

[Vinayakdwivedi]

What is changed

Fixes ImportError when importing RealtimeModel from
livekit-plugins-aws[realtime], which occurs with every version of
aws-sdk-bedrock-runtime allowed by the plugin's own dependency spec
(>=0.2.0).

Root cause

realtime_model.py imports BedrockRuntimeClient and Config directly:

from aws_sdk_bedrock_runtime.client import BedrockRuntimeClient
from aws_sdk_bedrock_runtime.config import Config, HTTPAuthSchemeResolver, SigV4AuthScheme

Neither of these import cleanly depending on the installed SDK version:

Version	Error
aws-sdk-bedrock-runtime==0.11.0	ImportError: cannot import name 'BedrockRuntimeClient' from 'aws_sdk_bedrock_runtime.client' — only AsyncBedrockRuntimeClient exists
aws-sdk-bedrock-runtime==0.10.0	ImportError: cannot import name 'Config' from 'aws_sdk_bedrock_runtime.config' — only AsyncBedrockRuntimeConfig exists

So there is no version in the supported range that lets the plugin import successfully.

Fix

Switched all usages to the async-native SDK classes:

# before
from aws_sdk_bedrock_runtime.client import (
    BedrockRuntimeClient,
    InvokeModelWithBidirectionalStreamOperationInput,
)
from aws_sdk_bedrock_runtime.config import Config, HTTPAuthSchemeResolver, SigV4AuthScheme

self._bedrock_client = BedrockRuntimeClient(config=config)

# after
from aws_sdk_bedrock_runtime.client import (
    AsyncBedrockRuntimeClient,
    InvokeModelWithBidirectionalStreamOperationInput,
)
from aws_sdk_bedrock_runtime.config import (
    AsyncBedrockRuntimeConfig as Config,
    HTTPAuthSchemeResolver,
    SigV4AuthScheme,
)

self._bedrock_client = AsyncBedrockRuntimeClient(config=config)

Also audited and updated all downstream usage of self._bedrock_client
(stream open/read/write) to properly await calls and use async with
/ async for where the SDK returns async streaming objects, since
AsyncBedrockRuntimeClient has no synchronous API surface.

Pinned aws-sdk-bedrock-runtime to >=<tested-version>,<next-major> in
pyproject.toml so the plugin doesn't silently drift out of
compatibility again if the SDK changes its export surface in the future.

Testing

Import check (reproduces the original issue):

pip install 'livekit-plugins-aws[realtime]'
python -c 'from livekit.plugins.aws.experimental.realtime import RealtimeModel'

• Before fix: ImportError (as described above, on both 0.10.0 and 0.11.0)
• After fix: imports cleanly

Functional check:

import asyncio
from livekit.plugins.aws.experimental.realtime import RealtimeModel

async def main():
    model = RealtimeModel(model="<bedrock-model-id>", region="<region>")
    session = model.session()
    # exercise a minimal bidirectional stream round-trip
    ...

asyncio.run(main())

• Confirmed invoke_model_with_bidirectional_stream opens correctly and
  input/output streaming works end-to-end against <the version you tested>.

Environment tested:

• Python 3.12
• aws-sdk-bedrock-runtime==<version>
• livekit-agents==1.7.0

Related

Fixes #6994
Related to #3244 (different root cause — Python version issue, already resolved, not affected by this change)

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[devin-ai-integration]

Devin Review found 1 potential issue.

View 1 additional finding in Devin Review. (Configure)

[devin-ai-integration]

🔴 Malformed docstring breaks module import

The edited docstring """Instantiate the Bedrock runtime client" "" opens a triple-quoted string that is never closed, so Python swallows the following code and raises a SyntaxError. The whole module fails to import.

Suggested change

	"""Instantiate the Bedrock runtime client" ""
	"""Instantiate the Bedrock runtime client"""

---

Was this helpful? React with 👍 or 👎 to provide feedback.

[Copilot]

Pull request overview

This PR updates the AWS Bedrock realtime integration to use the async-native aws_sdk_bedrock_runtime client/config types, addressing import compatibility issues across SDK versions when importing RealtimeModel.

Changes:

• Replace BedrockRuntimeClient with AsyncBedrockRuntimeClient.
• Replace Config import with AsyncBedrockRuntimeConfig (aliased as Config) and keep auth scheme wiring.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[longcw]

duplicates #7002