google-adk 0.0.2__py3-none-any.whl → 0.0.4__py3-none-any.whl

google/adk/tests/unittests/agents/test_llm_agent_callbacks.py

@@ -1,138 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from typing import Any
-from typing import Optional
-
-from google.adk.agents.callback_context import CallbackContext
-from google.adk.agents.llm_agent import Agent
-from google.adk.models import LlmRequest
-from google.adk.models import LlmResponse
-from google.genai import types
-from pydantic import BaseModel
-import pytest
-
-from .. import utils
-
-
-class MockBeforeModelCallback(BaseModel):
-  mock_response: str
-
-  def __call__(
-      self,
-      callback_context: CallbackContext,
-      llm_request: LlmRequest,
-  ) -> LlmResponse:
-    return LlmResponse(
-        content=utils.ModelContent(
-            [types.Part.from_text(text=self.mock_response)]
-        )
-    )
-
-
-class MockAfterModelCallback(BaseModel):
-  mock_response: str
-
-  def __call__(
-      self,
-      callback_context: CallbackContext,
-      llm_response: LlmResponse,
-  ) -> LlmResponse:
-    return LlmResponse(
-        content=utils.ModelContent(
-            [types.Part.from_text(text=self.mock_response)]
-        )
-    )
-
-
-def noop_callback(**kwargs) -> Optional[LlmResponse]:
-  pass
-
-
-@pytest.mark.asyncio
-async def test_before_model_callback():
-  responses = ['model_response']
-  mock_model = utils.MockModel.create(responses=responses)
-  agent = Agent(
-      name='root_agent',
-      model=mock_model,
-      before_model_callback=MockBeforeModelCallback(
-          mock_response='before_model_callback'
-      ),
-  )
-
-  runner = utils.TestInMemoryRunner(agent)
-  assert utils.simplify_events(
-      await runner.run_async_with_new_session('test')
-  ) == [
-      ('root_agent', 'before_model_callback'),
-  ]
-
-
-@pytest.mark.asyncio
-async def test_before_model_callback_noop():
-  responses = ['model_response']
-  mock_model = utils.MockModel.create(responses=responses)
-  agent = Agent(
-      name='root_agent',
-      model=mock_model,
-      before_model_callback=noop_callback,
-  )
-
-  runner = utils.TestInMemoryRunner(agent)
-  assert utils.simplify_events(
-      await runner.run_async_with_new_session('test')
-  ) == [
-      ('root_agent', 'model_response'),
-  ]
-
-
-@pytest.mark.asyncio
-async def test_before_model_callback_end():
-  responses = ['model_response']
-  mock_model = utils.MockModel.create(responses=responses)
-  agent = Agent(
-      name='root_agent',
-      model=mock_model,
-      before_model_callback=MockBeforeModelCallback(
-          mock_response='before_model_callback',
-      ),
-  )
-
-  runner = utils.TestInMemoryRunner(agent)
-  assert utils.simplify_events(
-      await runner.run_async_with_new_session('test')
-  ) == [
-      ('root_agent', 'before_model_callback'),
-  ]
-
-
-@pytest.mark.asyncio
-async def test_after_model_callback():
-  responses = ['model_response']
-  mock_model = utils.MockModel.create(responses=responses)
-  agent = Agent(
-      name='root_agent',
-      model=mock_model,
-      after_model_callback=MockAfterModelCallback(
-          mock_response='after_model_callback'
-      ),
-  )
-
-  runner = utils.TestInMemoryRunner(agent)
-  assert utils.simplify_events(
-      await runner.run_async_with_new_session('test')
-  ) == [
-      ('root_agent', 'after_model_callback'),
-  ]

google/adk/tests/unittests/agents/test_llm_agent_fields.py

@@ -1,231 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Unit tests for canonical_xxx fields in LlmAgent."""
-
-from typing import Any
-from typing import Optional
-
-from google.adk.agents.callback_context import CallbackContext
-from google.adk.agents.invocation_context import InvocationContext
-from google.adk.agents.llm_agent import LlmAgent
-from google.adk.agents.loop_agent import LoopAgent
-from google.adk.agents.readonly_context import ReadonlyContext
-from google.adk.models.llm_request import LlmRequest
-from google.adk.models.registry import LLMRegistry
-from google.adk.sessions.in_memory_session_service import InMemorySessionService
-from google.genai import types
-from pydantic import BaseModel
-import pytest
-
-
-def _create_readonly_context(
-    agent: LlmAgent, state: Optional[dict[str, Any]] = None
-) -> ReadonlyContext:
-  session_service = InMemorySessionService()
-  session = session_service.create_session(
-      app_name='test_app', user_id='test_user', state=state
-  )
-  invocation_context = InvocationContext(
-      invocation_id='test_id',
-      agent=agent,
-      session=session,
-      session_service=session_service,
-  )
-  return ReadonlyContext(invocation_context)
-
-
-def test_canonical_model_empty():
-  agent = LlmAgent(name='test_agent')
-
-  with pytest.raises(ValueError):
-    _ = agent.canonical_model
-
-
-def test_canonical_model_str():
-  agent = LlmAgent(name='test_agent', model='gemini-pro')
-
-  assert agent.canonical_model.model == 'gemini-pro'
-
-
-def test_canonical_model_llm():
-  llm = LLMRegistry.new_llm('gemini-pro')
-  agent = LlmAgent(name='test_agent', model=llm)
-
-  assert agent.canonical_model == llm
-
-
-def test_canonical_model_inherit():
-  sub_agent = LlmAgent(name='sub_agent')
-  parent_agent = LlmAgent(
-      name='parent_agent', model='gemini-pro', sub_agents=[sub_agent]
-  )
-
-  assert sub_agent.canonical_model == parent_agent.canonical_model
-
-
-def test_canonical_instruction_str():
-  agent = LlmAgent(name='test_agent', instruction='instruction')
-  ctx = _create_readonly_context(agent)
-
-  assert agent.canonical_instruction(ctx) == 'instruction'
-
-
-def test_canonical_instruction():
-  def _instruction_provider(ctx: ReadonlyContext) -> str:
-    return f'instruction: {ctx.state["state_var"]}'
-
-  agent = LlmAgent(name='test_agent', instruction=_instruction_provider)
-  ctx = _create_readonly_context(agent, state={'state_var': 'state_value'})
-
-  assert agent.canonical_instruction(ctx) == 'instruction: state_value'
-
-
-def test_canonical_global_instruction_str():
-  agent = LlmAgent(name='test_agent', global_instruction='global instruction')
-  ctx = _create_readonly_context(agent)
-
-  assert agent.canonical_global_instruction(ctx) == 'global instruction'
-
-
-def test_canonical_global_instruction():
-  def _global_instruction_provider(ctx: ReadonlyContext) -> str:
-    return f'global instruction: {ctx.state["state_var"]}'
-
-  agent = LlmAgent(
-      name='test_agent', global_instruction=_global_instruction_provider
-  )
-  ctx = _create_readonly_context(agent, state={'state_var': 'state_value'})
-
-  assert (
-      agent.canonical_global_instruction(ctx)
-      == 'global instruction: state_value'
-  )
-
-
-def test_output_schema_will_disable_transfer(caplog: pytest.LogCaptureFixture):
-  with caplog.at_level('WARNING'):
-
-    class Schema(BaseModel):
-      pass
-
-    agent = LlmAgent(
-        name='test_agent',
-        output_schema=Schema,
-    )
-
-    # Transfer is automatically disabled
-    assert agent.disallow_transfer_to_parent
-    assert agent.disallow_transfer_to_peers
-    assert (
-        'output_schema cannot co-exist with agent transfer configurations.'
-        in caplog.text
-    )
-
-
-def test_output_schema_with_sub_agents_will_throw():
-  class Schema(BaseModel):
-    pass
-
-  sub_agent = LlmAgent(
-      name='sub_agent',
-  )
-
-  with pytest.raises(ValueError):
-    _ = LlmAgent(
-        name='test_agent',
-        output_schema=Schema,
-        sub_agents=[sub_agent],
-    )
-
-
-def test_output_schema_with_tools_will_throw():
-  class Schema(BaseModel):
-    pass
-
-  def _a_tool():
-    pass
-
-  with pytest.raises(ValueError):
-    _ = LlmAgent(
-        name='test_agent',
-        output_schema=Schema,
-        tools=[_a_tool],
-    )
-
-
-def test_before_model_callback():
-  def _before_model_callback(
-      callback_context: CallbackContext,
-      llm_request: LlmRequest,
-  ) -> None:
-    return None
-
-  agent = LlmAgent(
-      name='test_agent', before_model_callback=_before_model_callback
-  )
-
-  # TODO: add more logic assertions later.
-  assert agent.before_model_callback is not None
-
-
-def test_validate_generate_content_config_thinking_config_throw():
-  with pytest.raises(ValueError):
-    _ = LlmAgent(
-        name='test_agent',
-        generate_content_config=types.GenerateContentConfig(
-            thinking_config=types.ThinkingConfig()
-        ),
-    )
-
-
-def test_validate_generate_content_config_tools_throw():
-  with pytest.raises(ValueError):
-    _ = LlmAgent(
-        name='test_agent',
-        generate_content_config=types.GenerateContentConfig(
-            tools=[types.Tool(function_declarations=[])]
-        ),
-    )
-
-
-def test_validate_generate_content_config_system_instruction_throw():
-  with pytest.raises(ValueError):
-    _ = LlmAgent(
-        name='test_agent',
-        generate_content_config=types.GenerateContentConfig(
-            system_instruction='system instruction'
-        ),
-    )
-
-
-def test_validate_generate_content_config_response_schema_throw():
-  class Schema(BaseModel):
-    pass
-
-  with pytest.raises(ValueError):
-    _ = LlmAgent(
-        name='test_agent',
-        generate_content_config=types.GenerateContentConfig(
-            response_schema=Schema
-        ),
-    )
-
-
-def test_allow_transfer_by_default():
-  sub_agent = LlmAgent(name='sub_agent')
-  agent = LlmAgent(name='test_agent', sub_agents=[sub_agent])
-
-  assert not agent.disallow_transfer_to_parent
-  assert not agent.disallow_transfer_to_peers

google/adk/tests/unittests/agents/test_loop_agent.py

@@ -1,136 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Testings for the SequentialAgent."""
-
-from typing import AsyncGenerator
-
-from google.adk.agents.base_agent import BaseAgent
-from google.adk.agents.invocation_context import InvocationContext
-from google.adk.agents.loop_agent import LoopAgent
-from google.adk.events import Event
-from google.adk.events import EventActions
-from google.adk.sessions.in_memory_session_service import InMemorySessionService
-from google.genai import types
-import pytest
-from typing_extensions import override
-
-
-class _TestingAgent(BaseAgent):
-
-  @override
-  async def _run_async_impl(
-      self, ctx: InvocationContext
-  ) -> AsyncGenerator[Event, None]:
-    yield Event(
-        author=self.name,
-        invocation_id=ctx.invocation_id,
-        content=types.Content(
-            parts=[types.Part(text=f'Hello, async {self.name}!')]
-        ),
-    )
-
-  @override
-  async def _run_live_impl(
-      self, ctx: InvocationContext
-  ) -> AsyncGenerator[Event, None]:
-    yield Event(
-        author=self.name,
-        invocation_id=ctx.invocation_id,
-        content=types.Content(
-            parts=[types.Part(text=f'Hello, live {self.name}!')]
-        ),
-    )
-
-
-class _TestingAgentWithEscalateAction(BaseAgent):
-
-  @override
-  async def _run_async_impl(
-      self, ctx: InvocationContext
-  ) -> AsyncGenerator[Event, None]:
-    yield Event(
-        author=self.name,
-        invocation_id=ctx.invocation_id,
-        content=types.Content(
-            parts=[types.Part(text=f'Hello, async {self.name}!')]
-        ),
-        actions=EventActions(escalate=True),
-    )
-
-
-def _create_parent_invocation_context(
-    test_name: str, agent: BaseAgent
-) -> InvocationContext:
-  session_service = InMemorySessionService()
-  session = session_service.create_session(
-      app_name='test_app', user_id='test_user'
-  )
-  return InvocationContext(
-      invocation_id=f'{test_name}_invocation_id',
-      agent=agent,
-      session=session,
-      session_service=session_service,
-  )
-
-
-@pytest.mark.asyncio
-async def test_run_async(request: pytest.FixtureRequest):
-  agent = _TestingAgent(name=f'{request.function.__name__}_test_agent')
-  loop_agent = LoopAgent(
-      name=f'{request.function.__name__}_test_loop_agent',
-      max_iterations=2,
-      sub_agents=[
-          agent,
-      ],
-  )
-  parent_ctx = _create_parent_invocation_context(
-      request.function.__name__, loop_agent
-  )
-  events = [e async for e in loop_agent.run_async(parent_ctx)]
-
-  assert len(events) == 2
-  assert events[0].author == agent.name
-  assert events[1].author == agent.name
-  assert events[0].content.parts[0].text == f'Hello, async {agent.name}!'
-  assert events[1].content.parts[0].text == f'Hello, async {agent.name}!'
-
-
-@pytest.mark.asyncio
-async def test_run_async_with_escalate_action(request: pytest.FixtureRequest):
-  non_escalating_agent = _TestingAgent(
-      name=f'{request.function.__name__}_test_non_escalating_agent'
-  )
-  escalating_agent = _TestingAgentWithEscalateAction(
-      name=f'{request.function.__name__}_test_escalating_agent'
-  )
-  loop_agent = LoopAgent(
-      name=f'{request.function.__name__}_test_loop_agent',
-      sub_agents=[non_escalating_agent, escalating_agent],
-  )
-  parent_ctx = _create_parent_invocation_context(
-      request.function.__name__, loop_agent
-  )
-  events = [e async for e in loop_agent.run_async(parent_ctx)]
-
-  # Only two events are generated because the sub escalating_agent escalates.
-  assert len(events) == 2
-  assert events[0].author == non_escalating_agent.name
-  assert events[1].author == escalating_agent.name
-  assert events[0].content.parts[0].text == (
-      f'Hello, async {non_escalating_agent.name}!'
-  )
-  assert events[1].content.parts[0].text == (
-      f'Hello, async {escalating_agent.name}!'
-  )

google/adk/tests/unittests/agents/test_parallel_agent.py

@@ -1,92 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Tests for the ParallelAgent."""
-
-import asyncio
-from typing import AsyncGenerator
-
-from google.adk.agents.base_agent import BaseAgent
-from google.adk.agents.invocation_context import InvocationContext
-from google.adk.agents.parallel_agent import ParallelAgent
-from google.adk.events import Event
-from google.adk.sessions.in_memory_session_service import InMemorySessionService
-from google.genai import types
-import pytest
-from typing_extensions import override
-
-
-class _TestingAgent(BaseAgent):
-
-  delay: float = 0
-  """The delay before the agent generates an event."""
-
-  @override
-  async def _run_async_impl(
-      self, ctx: InvocationContext
-  ) -> AsyncGenerator[Event, None]:
-    await asyncio.sleep(self.delay)
-    yield Event(
-        author=self.name,
-        branch=ctx.branch,
-        invocation_id=ctx.invocation_id,
-        content=types.Content(
-            parts=[types.Part(text=f'Hello, async {self.name}!')]
-        ),
-    )
-
-
-def _create_parent_invocation_context(
-    test_name: str, agent: BaseAgent
-) -> InvocationContext:
-  session_service = InMemorySessionService()
-  session = session_service.create_session(
-      app_name='test_app', user_id='test_user'
-  )
-  return InvocationContext(
-      invocation_id=f'{test_name}_invocation_id',
-      agent=agent,
-      session=session,
-      session_service=session_service,
-  )
-
-
-@pytest.mark.asyncio
-async def test_run_async(request: pytest.FixtureRequest):
-  agent1 = _TestingAgent(
-      name=f'{request.function.__name__}_test_agent_1',
-      delay=0.5,
-  )
-  agent2 = _TestingAgent(name=f'{request.function.__name__}_test_agent_2')
-  parallel_agent = ParallelAgent(
-      name=f'{request.function.__name__}_test_parallel_agent',
-      sub_agents=[
-          agent1,
-          agent2,
-      ],
-  )
-  parent_ctx = _create_parent_invocation_context(
-      request.function.__name__, parallel_agent
-  )
-  events = [e async for e in parallel_agent.run_async(parent_ctx)]
-
-  assert len(events) == 2
-  # agent2 generates an event first, then agent1. Because they run in parallel
-  # and agent1 has a delay.
-  assert events[0].author == agent2.name
-  assert events[1].author == agent1.name
-  assert events[0].branch.endswith(agent2.name)
-  assert events[1].branch.endswith(agent1.name)
-  assert events[0].content.parts[0].text == f'Hello, async {agent2.name}!'
-  assert events[1].content.parts[0].text == f'Hello, async {agent1.name}!'

google/adk/tests/unittests/agents/test_sequential_agent.py

@@ -1,114 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Testings for the SequentialAgent."""
-
-from typing import AsyncGenerator
-
-from google.adk.agents.base_agent import BaseAgent
-from google.adk.agents.invocation_context import InvocationContext
-from google.adk.agents.sequential_agent import SequentialAgent
-from google.adk.events import Event
-from google.adk.sessions.in_memory_session_service import InMemorySessionService
-from google.genai import types
-import pytest
-from typing_extensions import override
-
-
-class _TestingAgent(BaseAgent):
-
-  @override
-  async def _run_async_impl(
-      self, ctx: InvocationContext
-  ) -> AsyncGenerator[Event, None]:
-    yield Event(
-        author=self.name,
-        invocation_id=ctx.invocation_id,
-        content=types.Content(
-            parts=[types.Part(text=f'Hello, async {self.name}!')]
-        ),
-    )
-
-  @override
-  async def _run_live_impl(
-      self, ctx: InvocationContext
-  ) -> AsyncGenerator[Event, None]:
-    yield Event(
-        author=self.name,
-        invocation_id=ctx.invocation_id,
-        content=types.Content(
-            parts=[types.Part(text=f'Hello, live {self.name}!')]
-        ),
-    )
-
-
-def _create_parent_invocation_context(
-    test_name: str, agent: BaseAgent
-) -> InvocationContext:
-  session_service = InMemorySessionService()
-  session = session_service.create_session(
-      app_name='test_app', user_id='test_user'
-  )
-  return InvocationContext(
-      invocation_id=f'{test_name}_invocation_id',
-      agent=agent,
-      session=session,
-      session_service=session_service,
-  )
-
-
-@pytest.mark.asyncio
-async def test_run_async(request: pytest.FixtureRequest):
-  agent_1 = _TestingAgent(name=f'{request.function.__name__}_test_agent_1')
-  agent_2 = _TestingAgent(name=f'{request.function.__name__}_test_agent_2')
-  sequential_agent = SequentialAgent(
-      name=f'{request.function.__name__}_test_agent',
-      sub_agents=[
-          agent_1,
-          agent_2,
-      ],
-  )
-  parent_ctx = _create_parent_invocation_context(
-      request.function.__name__, sequential_agent
-  )
-  events = [e async for e in sequential_agent.run_async(parent_ctx)]
-
-  assert len(events) == 2
-  assert events[0].author == agent_1.name
-  assert events[1].author == agent_2.name
-  assert events[0].content.parts[0].text == f'Hello, async {agent_1.name}!'
-  assert events[1].content.parts[0].text == f'Hello, async {agent_2.name}!'
-
-
-@pytest.mark.asyncio
-async def test_run_live(request: pytest.FixtureRequest):
-  agent_1 = _TestingAgent(name=f'{request.function.__name__}_test_agent_1')
-  agent_2 = _TestingAgent(name=f'{request.function.__name__}_test_agent_2')
-  sequential_agent = SequentialAgent(
-      name=f'{request.function.__name__}_test_agent',
-      sub_agents=[
-          agent_1,
-          agent_2,
-      ],
-  )
-  parent_ctx = _create_parent_invocation_context(
-      request.function.__name__, sequential_agent
-  )
-  events = [e async for e in sequential_agent.run_live(parent_ctx)]
-
-  assert len(events) == 2
-  assert events[0].author == agent_1.name
-  assert events[1].author == agent_2.name
-  assert events[0].content.parts[0].text == f'Hello, live {agent_1.name}!'
-  assert events[1].content.parts[0].text == f'Hello, live {agent_2.name}!'