google--adk-python/tests/unittests/apps/test_apps.py

# 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 unittest.mock import Mock

from google.adk.agents.base_agent import BaseAgent
from google.adk.agents.context_cache_config import ContextCacheConfig
from google.adk.apps.app import App
from google.adk.apps.app import ResumabilityConfig
from google.adk.plugins.base_plugin import BasePlugin
from google.adk.workflow._base_node import BaseNode
import pytest


class TestApp:
  """Tests for App class."""

  def test_app_initialization(self):
    """Test that the app is initialized correctly without plugins."""
    mock_agent = Mock(spec=BaseAgent)
    app = App(name="test_app", root_agent=mock_agent)
    assert app.name == "test_app"
    assert app.root_agent == mock_agent
    assert app.plugins == []

  def test_app_initialization_with_plugins(self):
    """Test that the app is initialized correctly with plugins."""
    mock_agent = Mock(spec=BaseAgent)
    mock_plugin = Mock(spec=BasePlugin)
    app = App(name="test_app", root_agent=mock_agent, plugins=[mock_plugin])
    assert app.name == "test_app"
    assert app.root_agent == mock_agent
    assert app.plugins == [mock_plugin]

  def test_app_initialization_without_cache_config(self):
    """Test that the app is initialized correctly without context cache config."""
    mock_agent = Mock(spec=BaseAgent)
    app = App(name="test_app", root_agent=mock_agent)
    assert app.name == "test_app"
    assert app.root_agent == mock_agent
    assert app.context_cache_config is None

  def test_app_initialization_with_cache_config(self):
    """Test that the app is initialized correctly with context cache config."""
    mock_agent = Mock(spec=BaseAgent)
    cache_config = ContextCacheConfig(
        cache_intervals=15, ttl_seconds=3600, min_tokens=1024
    )

    app = App(
        name="test_app",
        root_agent=mock_agent,
        context_cache_config=cache_config,
    )

    assert app.name == "test_app"
    assert app.root_agent == mock_agent
    assert app.context_cache_config == cache_config
    assert app.context_cache_config.cache_intervals == 15
    assert app.context_cache_config.ttl_seconds == 3600
    assert app.context_cache_config.min_tokens == 1024

  def test_app_initialization_with_resumability_config(self):
    """Test that the app is initialized correctly with app config."""
    mock_agent = Mock(spec=BaseAgent)
    resumability_config = ResumabilityConfig(
        is_resumable=True,
    )
    app = App(
        name="test_app",
        root_agent=mock_agent,
        resumability_config=resumability_config,
    )

    assert app.name == "test_app"
    assert app.root_agent == mock_agent
    assert app.resumability_config == resumability_config
    assert app.resumability_config.is_resumable

  def test_app_with_all_components(self):
    """Test app with all components: agent, plugins, and cache config."""
    mock_agent = Mock(spec=BaseAgent)
    mock_plugin = Mock(spec=BasePlugin)
    cache_config = ContextCacheConfig(
        cache_intervals=20, ttl_seconds=7200, min_tokens=2048
    )
    resumability_config = ResumabilityConfig(
        is_resumable=True,
    )

    app = App(
        name="full_test_app",
        root_agent=mock_agent,
        plugins=[mock_plugin],
        context_cache_config=cache_config,
        resumability_config=resumability_config,
    )

    assert app.name == "full_test_app"
    assert app.root_agent == mock_agent
    assert app.plugins == [mock_plugin]
    assert app.context_cache_config == cache_config
    assert app.resumability_config == resumability_config
    assert app.resumability_config.is_resumable

  def test_app_cache_config_defaults(self):
    """Test that cache config has proper defaults when created."""
    mock_agent = Mock(spec=BaseAgent)
    cache_config = ContextCacheConfig()  # Use defaults

    app = App(
        name="default_cache_app",
        root_agent=mock_agent,
        context_cache_config=cache_config,
    )

    assert app.context_cache_config.cache_intervals == 10  # Default
    assert app.context_cache_config.ttl_seconds == 1800  # Default 30 minutes
    assert app.context_cache_config.min_tokens == 0  # Default

  def test_app_context_cache_config_is_optional(self):
    """Test that context_cache_config is truly optional."""
    mock_agent = Mock(spec=BaseAgent)

    # Should work without context_cache_config
    app = App(name="no_cache_app", root_agent=mock_agent)
    assert app.context_cache_config is None

    # Should work with explicit None
    app = App(
        name="explicit_none_app",
        root_agent=mock_agent,
        context_cache_config=None,
    )
    assert app.context_cache_config is None

  def test_app_resumability_config_defaults(self):
    """Test that app config has proper defaults when created."""
    mock_agent = Mock(spec=BaseAgent)

    app = App(
        name="default_resumability_config_app",
        root_agent=mock_agent,
        resumability_config=ResumabilityConfig(),
    )
    assert app.resumability_config is not None
    assert not app.resumability_config.is_resumable  # Default

  def test_app_resumability_config_is_optional(self):
    """Test that resumability_config is truly optional."""
    mock_agent = Mock(spec=BaseAgent)

    app = App(name="no_resumability_config_app", root_agent=mock_agent)
    assert app.resumability_config is None

    app = App(
        name="explicit_none_resumability_config_app",
        root_agent=mock_agent,
        resumability_config=None,
    )
    assert app.resumability_config is None

  def test_app_rejects_invalid_name(self):
    """Test that invalid application names are rejected."""
    mock_agent = Mock(spec=BaseAgent)

    with pytest.raises(ValueError):
      App(name="../escape_attempt", root_agent=mock_agent)

    with pytest.raises(ValueError):
      App(name="nested/path", root_agent=mock_agent)

    with pytest.raises(ValueError):
      App(name="windows\\path", root_agent=mock_agent)

  def test_app_name_must_be_valid(self):
    mock_agent = Mock(spec=BaseAgent)

    # Hyphens are allowed
    App(name="valid-name", root_agent=mock_agent)

    with pytest.raises(ValueError):
      App(name="invalid name", root_agent=mock_agent)

    with pytest.raises(ValueError):
      App(name="invalid@name", root_agent=mock_agent)

  def test_app_name_cannot_be_user(self):
    mock_agent = Mock(spec=BaseAgent)

    with pytest.raises(ValueError):
      App(name="user", root_agent=mock_agent)


class TestAppRootNode:
  """Tests for App.root_agent accepting BaseNode."""

  def test_app_with_root_node(self):
    """Test App creation with a BaseNode as root_agent."""
    node = BaseNode(name="test_node")
    app = App(name="test_app", root_agent=node)
    assert app.root_agent is node

  def test_app_rejects_none_root_agent(self):
    """Test that not providing root_agent raises."""
    with pytest.raises(ValueError, match="root_agent must be provided"):
      App(name="test_app")

  def test_app_rejects_invalid_root_agent(self):
    """Test that root_agent must be a BaseAgent or BaseNode instance."""
    with pytest.raises(
        TypeError, match="root_agent must be a BaseAgent or BaseNode"
    ):
      App(name="test_app", root_agent="not_a_node")