chore: import upstream snapshot with attribution

tests/integration/utils/__init__.py

@@ -0,0 +1,16 @@
+# Copyright 2026 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 .asserts import *
+from .test_runner import TestRunner

tests/integration/utils/asserts.py

@@ -0,0 +1,75 @@
+# Copyright 2026 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 TypedDict
+
+from .test_runner import TestRunner
+
+
+class Message(TypedDict):
+  agent_name: str
+  expected_text: str
+
+
+def assert_current_agent_is(agent_name: str, *, agent_runner: TestRunner):
+  assert agent_runner.get_current_agent_name() == agent_name
+
+
+def assert_agent_says(
+    expected_text: str, *, agent_name: str, agent_runner: TestRunner
+):
+  for event in reversed(agent_runner.get_events()):
+    if event.author == agent_name and event.content.parts[0].text:
+      assert event.content.parts[0].text.strip() == expected_text
+      return
+
+
+def assert_agent_says_in_order(
+    expected_conversation: list[Message], agent_runner: TestRunner
+):
+  expected_conversation_idx = len(expected_conversation) - 1
+  for event in reversed(agent_runner.get_events()):
+    if event.content.parts and event.content.parts[0].text:
+      assert (
+          event.author
+          == expected_conversation[expected_conversation_idx]['agent_name']
+      )
+      assert (
+          event.content.parts[0].text.strip()
+          == expected_conversation[expected_conversation_idx]['expected_text']
+      )
+      expected_conversation_idx -= 1
+      if expected_conversation_idx < 0:
+        return
+
+
+def assert_agent_transfer_path(
+    expected_path: list[str], *, agent_runner: TestRunner
+):
+  events = agent_runner.get_events()
+  idx_in_expected_path = len(expected_path) - 1
+  # iterate events in reverse order
+  for event in reversed(events):
+    function_calls = event.get_function_calls()
+    if (
+        len(function_calls) == 1
+        and function_calls[0].name == 'transfer_to_agent'
+    ):
+      assert (
+          function_calls[0].args['agent_name']
+          == expected_path[idx_in_expected_path]
+      )
+      idx_in_expected_path -= 1
+      if idx_in_expected_path < 0:
+        return

tests/integration/utils/test_runner.py

@@ -0,0 +1,97 @@
+# Copyright 2026 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.
+
+import importlib
+from typing import Optional
+
+from google.adk import Agent
+from google.adk import Runner
+from google.adk.artifacts.base_artifact_service import BaseArtifactService
+from google.adk.artifacts.in_memory_artifact_service import InMemoryArtifactService
+from google.adk.events.event import Event
+from google.adk.sessions.base_session_service import BaseSessionService
+from google.adk.sessions.in_memory_session_service import InMemorySessionService
+from google.adk.sessions.session import Session
+from google.genai import types
+
+
+class TestRunner:
+  """Agents runner for testing."""
+
+  app_name = "test_app"
+  user_id = "test_user"
+
+  def __init__(
+      self,
+      agent: Agent,
+      artifact_service: BaseArtifactService = InMemoryArtifactService(),
+      session_service: BaseSessionService = InMemorySessionService(),
+  ) -> None:
+    self.agent = agent
+    self.agent_client = Runner(
+        app_name=self.app_name,
+        agent=agent,
+        artifact_service=artifact_service,
+        session_service=session_service,
+    )
+    self.session_service = session_service
+    self.current_session_id = session_service.create_session(
+        app_name=self.app_name, user_id=self.user_id
+    ).id
+
+  def new_session(self, session_id: Optional[str] = None) -> None:
+    self.current_session_id = self.session_service.create_session(
+        app_name=self.app_name, user_id=self.user_id, session_id=session_id
+    ).id
+
+  def run(self, prompt: str) -> list[Event]:
+    current_session = self.session_service.get_session(
+        app_name=self.app_name,
+        user_id=self.user_id,
+        session_id=self.current_session_id,
+    )
+    assert current_session is not None
+
+    return list(
+        self.agent_client.run(
+            user_id=current_session.user_id,
+            session_id=current_session.id,
+            new_message=types.Content(
+                role="user",
+                parts=[types.Part.from_text(text=prompt)],
+            ),
+        )
+    )
+
+  def get_current_session(self) -> Optional[Session]:
+    return self.session_service.get_session(
+        app_name=self.app_name,
+        user_id=self.user_id,
+        session_id=self.current_session_id,
+    )
+
+  def get_events(self) -> list[Event]:
+    return self.get_current_session().events
+
+  @classmethod
+  def from_agent_name(cls, agent_name: str):
+    agent_module_path = f"tests.integration.fixture.{agent_name}"
+    agent_module = importlib.import_module(agent_module_path)
+    agent: Agent = agent_module.agent.root_agent
+    return cls(agent)
+
+  def get_current_agent_name(self) -> str:
+    return self.agent_client._find_agent_to_run(
+        self.get_current_session(), self.agent
+    ).name