George Weale
456524d714
Co-authored-by: George Weale <gweale@google.com> PiperOrigin-RevId: 960421043
137 lines
4.6 KiB
Python
137 lines
4.6 KiB
Python
# 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.
|
|
|
|
"""Tests for ToolConfirmation.
|
|
|
|
Verifies that ToolConfirmation correctly stores and validates confirmation
|
|
states.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
|
|
from google.adk.tools.tool_confirmation import ToolConfirmation
|
|
from pydantic import ValidationError
|
|
import pytest
|
|
|
|
# ToolConfirmation is gated behind an experimental feature flag, which emits a
|
|
# UserWarning on use; that is expected and not under test here.
|
|
pytestmark = pytest.mark.filterwarnings("ignore::UserWarning")
|
|
|
|
|
|
class TestToolConfirmation:
|
|
"""Tests for the ToolConfirmation model."""
|
|
|
|
def test_default_values_are_empty(self):
|
|
"""A default ToolConfirmation has empty hint, unconfirmed, and no payload."""
|
|
confirmation = ToolConfirmation()
|
|
|
|
assert confirmation.hint == ""
|
|
assert confirmation.confirmed is False
|
|
assert confirmation.payload is None
|
|
|
|
def test_initialization_retains_provided_values(self):
|
|
"""ToolConfirmation stores values provided during initialization."""
|
|
confirmation = ToolConfirmation(
|
|
hint="please confirm", confirmed=True, payload={"amount": 10}
|
|
)
|
|
|
|
assert confirmation.hint == "please confirm"
|
|
assert confirmation.confirmed is True
|
|
assert confirmation.payload == {"amount": 10}
|
|
|
|
@pytest.mark.parametrize(
|
|
"payload_value",
|
|
[
|
|
[1, 2, 3],
|
|
"raw",
|
|
],
|
|
)
|
|
def test_payload_accepts_json_serializable_values(self, payload_value):
|
|
"""ToolConfirmation payload accepts various JSON-serializable values."""
|
|
confirmation = ToolConfirmation(payload=payload_value)
|
|
|
|
assert confirmation.payload == payload_value
|
|
|
|
@pytest.mark.parametrize(
|
|
"payload_value",
|
|
[
|
|
lambda x: x,
|
|
object(),
|
|
],
|
|
)
|
|
def test_payload_accepts_non_json_serializable_values(self, payload_value):
|
|
"""ToolConfirmation payload accepts non-JSON-serializable values."""
|
|
confirmation = ToolConfirmation(payload=payload_value)
|
|
|
|
assert confirmation.payload == payload_value
|
|
|
|
def test_initialization_fails_with_extra_fields(self):
|
|
"""ToolConfirmation forbids extra fields during initialization."""
|
|
with pytest.raises(ValidationError):
|
|
ToolConfirmation(unexpected="value")
|
|
|
|
def test_serialization_round_trip_preserves_equality(self):
|
|
"""ToolConfirmation can be serialized and deserialized back to its original state."""
|
|
original = ToolConfirmation(
|
|
hint="confirm transfer", confirmed=True, payload={"to": "bob"}
|
|
)
|
|
|
|
dumped = original.model_dump()
|
|
validated = ToolConfirmation.model_validate(dumped)
|
|
|
|
assert validated == original
|
|
|
|
|
|
class TestFromResponseDict:
|
|
"""Tests for ToolConfirmation.from_response_dict."""
|
|
|
|
def test_plain_dict_is_validated_directly(self):
|
|
confirmation = ToolConfirmation.from_response_dict(
|
|
{"hint": "confirm transfer", "confirmed": True, "payload": {"to": "b"}}
|
|
)
|
|
|
|
assert confirmation.hint == "confirm transfer"
|
|
assert confirmation.confirmed is True
|
|
assert confirmation.payload == {"to": "b"}
|
|
|
|
def test_single_response_key_is_unwrapped_and_json_decoded(self):
|
|
"""The client wraps the confirmation in a JSON string under 'response'."""
|
|
confirmation = ToolConfirmation.from_response_dict(
|
|
{"response": json.dumps({"hint": "h", "confirmed": True})}
|
|
)
|
|
|
|
assert confirmation.hint == "h"
|
|
assert confirmation.confirmed is True
|
|
|
|
def test_response_key_alongside_other_keys_is_not_unwrapped(self):
|
|
"""Only a lone 'response' key is the wrapper format, so this is direct."""
|
|
with pytest.raises(ValidationError):
|
|
ToolConfirmation.from_response_dict(
|
|
{"response": json.dumps({"confirmed": True}), "hint": "h"}
|
|
)
|
|
|
|
def test_empty_dict_yields_defaults(self):
|
|
confirmation = ToolConfirmation.from_response_dict({})
|
|
|
|
assert confirmation.hint == ""
|
|
assert confirmation.confirmed is False
|
|
assert confirmation.payload is None
|
|
|
|
def test_malformed_wrapper_json_is_not_swallowed(self):
|
|
"""A wrapper whose payload is not JSON is a caller error, not a default."""
|
|
with pytest.raises(json.JSONDecodeError):
|
|
ToolConfirmation.from_response_dict({"response": "not json"})
|