from google.adk.agents import Agent from google.adk.agents.invocation_context import InvocationContext from google.adk.agents.readonly_context import ReadonlyContext from google.adk.sessions import Session from google.adk.utils import instructions_utils import pytest from .. import testing_utils class MockArtifactService: def __init__(self, artifacts: dict): self.artifacts = artifacts async def load_artifact(self, app_name, user_id, session_id, filename): if filename in self.artifacts: return self.artifacts[filename] else: raise KeyError(f"Artifact '{filename}' not found.") async def _create_test_readonly_context( state: dict = None, artifact_service: MockArtifactService = None, app_name: str = "test_app", user_id: str = "test_user", session_id: str = "test_session_id", ) -> ReadonlyContext: agent = Agent( model="gemini-2.0-flash", name="agent", instruction="test", ) invocation_context = await testing_utils.create_invocation_context( agent=agent ) invocation_context.session = Session( state=state if state else {}, app_name=app_name, user_id=user_id, id=session_id, ) invocation_context.artifact_service = artifact_service return ReadonlyContext(invocation_context) @pytest.mark.asyncio async def test_inject_session_state(): instruction_template = "Hello {user_name}, you are in {app_state} state." invocation_context = await _create_test_readonly_context( state={"user_name": "Foo", "app_state": "active"} ) populated_instruction = await instructions_utils.inject_session_state( instruction_template, invocation_context ) assert populated_instruction == "Hello Foo, you are in active state." @pytest.mark.asyncio async def test_inject_session_state_with_artifact(): instruction_template = "The artifact content is: {artifact.my_file}" mock_artifact_service = MockArtifactService( {"my_file": "This is my artifact content."} ) invocation_context = await _create_test_readonly_context( artifact_service=mock_artifact_service ) populated_instruction = await instructions_utils.inject_session_state( instruction_template, invocation_context ) assert ( populated_instruction == "The artifact content is: This is my artifact content." ) @pytest.mark.asyncio async def test_inject_session_state_with_optional_state(): instruction_template = "Optional value: {optional_value?}" invocation_context = await _create_test_readonly_context() populated_instruction = await instructions_utils.inject_session_state( instruction_template, invocation_context ) assert populated_instruction == "Optional value: " @pytest.mark.asyncio async def test_inject_session_state_with_missing_state_raises_key_error(): instruction_template = "Hello {missing_key}!" invocation_context = await _create_test_readonly_context( state={"user_name": "Foo"} ) with pytest.raises( KeyError, match="Context variable not found: `missing_key`." ): await instructions_utils.inject_session_state( instruction_template, invocation_context ) @pytest.mark.asyncio async def test_inject_session_state_with_missing_artifact_raises_key_error(): instruction_template = "The artifact content is: {artifact.missing_file}" mock_artifact_service = MockArtifactService( {"my_file": "This is my artifact content."} ) invocation_context = await _create_test_readonly_context( artifact_service=mock_artifact_service ) with pytest.raises(KeyError, match="Artifact 'missing_file' not found."): await instructions_utils.inject_session_state( instruction_template, invocation_context ) @pytest.mark.asyncio async def test_inject_session_state_with_invalid_state_name_returns_original(): instruction_template = "Hello {invalid-key}!" invocation_context = await _create_test_readonly_context( state={"user_name": "Foo"} ) populated_instruction = await instructions_utils.inject_session_state( instruction_template, invocation_context ) assert populated_instruction == "Hello {invalid-key}!" @pytest.mark.asyncio async def test_inject_session_state_with_invalid_prefix_state_name_returns_original(): instruction_template = "Hello {invalid:key}!" invocation_context = await _create_test_readonly_context( state={"user_name": "Foo"} ) populated_instruction = await instructions_utils.inject_session_state( instruction_template, invocation_context ) assert populated_instruction == "Hello {invalid:key}!" @pytest.mark.asyncio async def test_inject_session_state_with_valid_prefix_state(): instruction_template = "Hello {app:user_name}!" invocation_context = await _create_test_readonly_context( state={"app:user_name": "Foo"} ) populated_instruction = await instructions_utils.inject_session_state( instruction_template, invocation_context ) assert populated_instruction == "Hello Foo!" @pytest.mark.asyncio async def test_inject_session_state_with_multiple_variables_and_artifacts(): instruction_template = """ Hello {user_name}, You are {user_age} years old. Your favorite color is {favorite_color?}. The artifact says: {artifact.my_file} And another optional artifact: {artifact.other_file} """ mock_artifact_service = MockArtifactService({ "my_file": "This is my artifact content.", "other_file": "This is another artifact content.", }) invocation_context = await _create_test_readonly_context( state={"user_name": "Foo", "user_age": 30, "favorite_color": "blue"}, artifact_service=mock_artifact_service, ) populated_instruction = await instructions_utils.inject_session_state( instruction_template, invocation_context ) expected_instruction = """ Hello Foo, You are 30 years old. Your favorite color is blue. The artifact says: This is my artifact content. And another optional artifact: This is another artifact content. """ assert populated_instruction == expected_instruction @pytest.mark.asyncio async def test_inject_session_state_with_empty_artifact_name_raises_key_error(): instruction_template = "The artifact content is: {artifact.}" mock_artifact_service = MockArtifactService( {"my_file": "This is my artifact content."} ) invocation_context = await _create_test_readonly_context( artifact_service=mock_artifact_service ) with pytest.raises(KeyError, match="Artifact '' not found."): await instructions_utils.inject_session_state( instruction_template, invocation_context ) @pytest.mark.asyncio async def test_inject_session_state_artifact_service_not_initialized_raises_value_error(): instruction_template = "The artifact content is: {artifact.my_file}" invocation_context = await _create_test_readonly_context() with pytest.raises(ValueError, match="Artifact service is not initialized."): await instructions_utils.inject_session_state( instruction_template, invocation_context )