test: add comprehensive unit, integration, and e2e test suites

Introduce complete test coverage for the ARTEMIS platform across multiple layers:
Unit tests: Add tests for agent nodes (Planner, Operator, Validator, Diagnoser, FlashRunner, Explorer), tools, utils (OCR/XML fusion, UI hierarchy), and data engine.
Integration tests: Add live tool verification, reactive runner, IME, and standalone workflow tests.
E2E tests: Add end-to-end scenario tests for media playback and failure recovery flows.
Fixtures & mocks: Add mock inputs (audio, video, screenshot) and test utilities.
This commit is contained in:
chiwanko11 committed 2026-08-13 12:18:32 -07:00
1 parent c1803fcb86
commit 5d2283deaa
115 files changed
+22813

No files matched your search

+650
View File
@@ -0,0 +1,650 @@
# 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 hashlib
from artemis.utils.task_tree import (
build_plan_and_history,
get_active_subgoal_hashes,
get_recent_subgoal_hashes,
)
def test_build_plan_and_history_separated_layout():
plan = """- [ ] Open Settings app
- [ ] Navigate to System settings"""
# No steps executed
output = build_plan_and_history(plan, [], "default")
assert plan in output
assert "--- Execution History ---" in output
assert "No steps executed yet." in output
# With steps
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "2.5s",
"summary": "Launched settings app",
"operator_raw_thinking": "Thought 1",
"action_taken": [{"action": "launch_app"}],
"last_execution_result": {"status": "success"},
}
]
output = build_plan_and_history(plan, steps, "default", last_n_detailed=1)
assert plan in output
assert "--- Execution History ---" in output
assert "- **Step 1 (Most Recent Step, Start: 2.5s)**" in output
assert " - Thought 1" in output
assert " * [Planned Action]: Launched app 'None'" in output
def test_build_plan_and_history_granularities():
plan = """- [x] Open Settings app
- [/] Navigate to System settings
- [ ] Navigate to Languages & input"""
subgoal_hash_1 = hashlib.md5(b"Open Settings app").hexdigest()
subgoal_hash_2 = hashlib.md5(b"Navigate to System settings").hexdigest()
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "2.5s",
"summary": "Launched settings",
"operator_raw_thinking": "Thought 1",
"action_taken": [{"action": "launch_app"}],
"last_execution_result": {"status": "success"},
"extra_metadata": {"subgoal_hash": subgoal_hash_1},
},
{
"step_id": "step_2",
"step_number": 2,
"relative_time": "8.0s",
"summary": "Swiped down",
"operator_raw_thinking": "Thought 2",
"action_taken": [{"action": "swipe"}],
"last_execution_result": {"status": "success"},
"extra_metadata": {"subgoal_hash": subgoal_hash_2},
},
{
"step_id": "step_3",
"step_number": 3,
"relative_time": "15.0s",
"summary": "Clicked System settings",
"operator_raw_thinking": "Thought 3",
"action_taken": [{"action": "click"}],
"last_execution_result": {"status": "success"},
"extra_metadata": {"subgoal_hash": subgoal_hash_2},
},
]
# Test last_n_detailed = 0 (high-level analysis context, all summarized)
output_0 = build_plan_and_history(plan, steps, subgoal_hash_2, last_n_detailed=0)
assert "- *Step 1 (Start: 2.5s): Launched settings*" in output_0
assert "- *Step 2 (Start: 8.0s): Swiped down*" in output_0
assert "- *Step 3 (Start: 15.0s): Clicked System settings*" in output_0
assert "*Thought*: Thought 3" not in output_0
# Test last_n_detailed = 1 (normal execution context, only last detailed)
output_1 = build_plan_and_history(plan, steps, subgoal_hash_2, last_n_detailed=1)
assert "- *Step 1 (Start: 2.5s): Launched settings*" in output_1
assert "- *Step 2 (Start: 8.0s): Swiped down*" in output_1
assert "- **Step 3 (Most Recent Step, Start: 15.0s)**" in output_1
assert " - Thought 3" in output_1
# Test last_n_detailed = 3 (committee context, last 3 detailed)
output_3 = build_plan_and_history(plan, steps, subgoal_hash_2, last_n_detailed=3)
assert "- **Step 1 (Start: 2.5s)**" in output_3
assert " - Thought 1" in output_3
assert "- **Step 2 (Start: 8.0s)**" in output_3
assert " - Thought 2" in output_3
assert "- **Step 3 (Most Recent Step, Start: 15.0s)**" in output_3
assert " - Thought 3" in output_3
# Test keep_subgoal_hashes (milestone filtering for checker/diagnoser)
# Only keep steps for subgoal_hash_2
output_filter = build_plan_and_history(
plan, steps, subgoal_hash_2, keep_subgoal_hashes={subgoal_hash_2}
)
assert "Launched settings" not in output_filter # Step 1 is filtered out!
assert "Swiped down" in output_filter # Step 2 belongs to subgoal_hash_2, kept!
assert " - Thought 3" in output_filter # Step 3 is the last step, kept detailed!
def test_get_active_subgoal_hashes_fallback():
# Scenario 1: Normal Active Subgoal (Level 1 [/] active)
plan_normal = """- [x] Open Settings app
- [/] Navigate to System settings
- [ ] Navigate to Languages & input"""
h_settings = hashlib.md5(b"Open Settings app").hexdigest()
h_system = hashlib.md5(b"Navigate to System settings").hexdigest()
parent, sub = get_active_subgoal_hashes(plan_normal)
assert parent == h_system
assert sub is None
# Scenario 2: Indented Sub-subgoal Active (Level 2 [/] active, consolidated to parent)
plan_indented = """- [x] Open Settings app
- [/] Navigate to System settings
- [/] Scroll down to find System settings
- [ ] Navigate to Languages & input"""
parent, sub = get_active_subgoal_hashes(plan_indented)
assert parent == h_system
assert sub is None
# Scenario 3: Safe Fallback (All pending "[ ]", no active subgoal)
plan_fallback = """- [ ] Open Settings app
- [ ] Navigate to System settings
- [ ] Navigate to Languages & input"""
parent, sub = get_active_subgoal_hashes(plan_fallback)
assert parent == h_settings # Successfully fell back to the first subgoal's hash!
assert sub is None
# Scenario 4: All Completed (All "[x]", no active subgoal)
plan_all_done = """- [x] Open Settings app
- [x] Navigate to System settings
- [x] Navigate to Languages & input"""
parent, sub = get_active_subgoal_hashes(plan_all_done)
assert parent == "default"
assert sub is None
def test_build_plan_and_history_sliding_window():
plan = """- [x] Subgoal 1
- [x] Subgoal 2
- [/] Subgoal 3"""
subgoal_hash_1 = hashlib.md5(b"Subgoal 1").hexdigest()
subgoal_hash_2 = hashlib.md5(b"Subgoal 2").hexdigest()
subgoal_hash_3 = hashlib.md5(b"Subgoal 3").hexdigest()
steps = [
{
"step_id": "step_1",
"step_number": 1,
"summary": "Step 1 summary",
"extra_metadata": {"subgoal_hash": subgoal_hash_1},
},
{
"step_id": "step_2",
"step_number": 2,
"summary": "Step 2 summary",
"extra_metadata": {"subgoal_hash": subgoal_hash_1},
},
{
"step_id": "step_3",
"step_number": 3,
"summary": "Step 3 summary",
"extra_metadata": {"subgoal_hash": subgoal_hash_2},
},
{
"step_id": "step_4",
"step_number": 4,
"summary": "Step 4 summary",
"extra_metadata": {"subgoal_hash": subgoal_hash_3},
},
{
"step_id": "step_5",
"step_number": 5,
"summary": "Step 5 summary",
"extra_metadata": {"subgoal_hash": subgoal_hash_3},
},
{
"step_id": "step_6",
"step_number": 6,
"summary": "Step 6 summary",
"extra_metadata": {"subgoal_hash": subgoal_hash_3},
},
{
"step_id": "step_7",
"step_number": 7,
"summary": "Step 7 summary",
"extra_metadata": {"subgoal_hash": subgoal_hash_3},
},
]
# Case 1: min_summaries = 2
# subgoal 3 has 4 steps (4, 5, 6, 7). This already exceeds min_summaries=2.
# So older steps (1, 2, 3) from completed subgoals should be compressed/hidden!
output_c1 = build_plan_and_history(
plan, steps, subgoal_hash_3, min_summaries=2, last_n_detailed=0
)
assert "Step 1 summary" not in output_c1
assert "Step 2 summary" not in output_c1
assert "Step 3 summary" not in output_c1
assert "Step 4 summary" in output_c1
assert "Step 5 summary" in output_c1
assert "Step 6 summary" in output_c1
assert "Step 7 summary" in output_c1
# Case 2: min_summaries = 5
# subgoal 3 has 4 steps (4, 5, 6, 7), which translates to 3 non-last steps.
# To reach min_summaries=5 non-last steps, the sliding window slides back to keep Step 3 and Step 2 visible!
# But Step 1 should still be compressed/hidden.
output_c2 = build_plan_and_history(
plan, steps, subgoal_hash_3, min_summaries=5, last_n_detailed=0
)
assert "Step 1 summary" not in output_c2
assert "Step 2 summary" in output_c2 # Kept visible by sliding window!
assert "Step 3 summary" in output_c2 # Kept visible by sliding window!
assert "Step 4 summary" in output_c2
assert "Step 5 summary" in output_c2
assert "Step 6 summary" in output_c2
assert "Step 7 summary" in output_c2
def test_build_plan_and_history_clean_success_result():
plan = "- [ ] Subgoal 1"
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "2.5s",
"summary": "Swiped screen",
"action_taken": [{"action": "swipe"}],
"last_execution_result": {
"executed_actions": [{"action": "swipe"}],
"status": "success",
},
}
]
output = build_plan_and_history(plan, steps, "default", last_n_detailed=1)
# The output should contain "status": "success" but NOT the redundant "executed_actions"
# Success results are stripped under Factual Realism
assert "* [Validator Execution Result]" not in output
assert "executed_actions" not in output
def test_build_plan_and_history_with_tool_calls():
plan = "- [ ] Subgoal 1"
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "2.5s",
"summary": "Read note and swiped",
"action_taken": [{"action": "swipe"}],
"last_execution_result": {"status": "success"},
"tool_calls": [
{
"name": "read_note",
"payload": {
"args": {"key": "other_note"},
"result": "- [ ] Milestone",
},
"status": "success",
}
],
}
]
output = build_plan_and_history(plan, steps, "default", last_n_detailed=1)
assert "* [Operator Decision Loop]:" in output
assert '`read_note({"key": "other_note"})` -> - [ ] Milestone' in output
def test_build_plan_and_history_with_interleaved_events():
plan = "- [ ] Subgoal 1"
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "2.5s",
"summary": "Read note and thought",
"action_taken": [{"action": "swipe"}],
"last_execution_result": {"status": "success"},
"interleaved_events": [
{"type": "thought", "content": "I want to search for files."},
{
"type": "tool_call",
"name": "list_notes",
"args": {"dir": "/notes"},
"result": ["notes.txt"],
},
{"type": "thought", "content": "I see notes.txt, let's read it."},
{
"type": "tool_call",
"name": "read_note",
"args": {"file": "notes.txt"},
"result": "Milestone plan",
},
],
}
]
output = build_plan_and_history(plan, steps, "default", last_n_detailed=1)
# It should render interleaved thoughts and tool calls in natural order
assert " - I want to search for files." in output
assert ' - [Tool Call]: `list_notes({"dir": "/notes"})` -> [\'notes.txt\']' in output
assert " - I see notes.txt, let's read it." in output
assert ' - [Tool Call]: `read_note({"file": "notes.txt"})` -> Milestone plan' in output
# It should use the new section header
assert "* [Operator Decision Loop]:" in output
def test_build_plan_and_history_concatenates_thoughts():
plan = "- [ ] Subgoal 1"
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "2.5s",
"summary": "Step with multiple thoughts",
"action_taken": [{"action": "click", "thought": "Action thought"}],
"operator_raw_thinking": "Raw thought",
"last_execution_result": {"status": "success"},
"interleaved_events": [
{"type": "thought", "content": "Event thought"},
],
}
]
output = build_plan_and_history(plan, steps, "default", last_n_detailed=1)
# Check that all thoughts are concatenated and visible in the output
assert " - Action thought" in output
assert " - Event thought" in output
assert " - Raw thought" in output
def test_build_plan_and_history_chronological_last_step():
plan = "- [ ] Subgoal 1"
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "2.5s",
"summary": "Completed search",
"action_taken": [{"action": "click", "target_text": "Search"}],
"last_execution_result": {"status": "success"},
"interleaved_events": [
{"type": "thought", "content": "I should find search icon."},
{
"type": "tool_call",
"name": "ask_explorer",
"args": {"query": "search icon"},
"result": {"center": [500, 600]},
},
{
"type": "native_thought",
"content": "Clicking coordinates [500, 600] now.",
},
],
}
]
output = build_plan_and_history(
plan, steps, "default", last_n_detailed=1, chronological_last_step=True
)
assert plan in output
assert "--- Execution History ---" in output
assert "- **Step 1 (Most Recent Step, Start: 2.5s)**" in output
assert "* [Operator Decision Loop]:" in output
assert " - I should find search icon." in output
assert (
'- [Tool Call]: `ask_explorer({"query": "search icon"})` -> {"center":'
" [500, 600]}" in output
)
assert " - Clicking coordinates [500, 600] now." in output
assert "* [Planned Action]: Tapped 'Search' at None" in output
assert "* [Validator Execution Result]" not in output
def test_build_plan_and_history_safety_net_and_failure_analyzer():
plan = "- [ ] Subgoal 1"
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "5.0s",
"summary": "Repaired click search",
"action_taken": [{"action": "click", "target_text": "Search"}],
"last_execution_result": {"status": "success"},
"interleaved_events": [
{"type": "thought", "content": "Let's click search."},
# Safety net failure
{
"type": "tool_call",
"name": "safety_net_validation",
"args": {"target": "Search"},
"result": [
False,
"TARGET_DISAPPEARED",
"Target button is not visible",
],
},
# Failure Analyzer intervention
{
"type": "failure_analyzer_thought",
"content": ("The search button is covered by keyboard, need to go BACK first."),
},
{
"type": "tool_call",
"name": "_exec_press_key",
"args": {"key": "BACK", "state": "<State>"},
"result": ["Pressed key BACK", "<Bytes>", "/path/to/shot.jpg"],
},
{
"type": "failure_analyzer_thought",
"content": "Keyboard is closed, now re-executing search tap.",
},
{
"type": "tool_call",
"name": "_exec_click",
"args": {"target": [500, 600]},
"result": ["Tapped search button successfully", "<Bytes>"],
},
{
"type": "tool_call",
"name": "report_failure_analysis",
"args": {
"status": "fixed",
"analysis": "Closed keyboard and tapped search.",
},
"result": "Success",
},
],
}
]
output = build_plan_and_history(
plan, steps, "default", last_n_detailed=1, chronological_last_step=True
)
assert "- **Step 1 (Most Recent Step, Start: 5.0s)**" in output
assert "* [Operator Decision Loop]:" in output
assert " - Let's click search." in output
assert (
"* [Planned Action]: Tapped 'Search' at None (Intercepted by"
" Pre-Execution Safety Net)" in output
)
assert "* [Pre-Execution Safety Net]:" in output
assert "- [Safety Net Check]: (Action not executed: Target button is not visible)" in output
assert "* [Failure Analyzer Recovery Loop]:" in output
assert " - [Tool Call]: Pressed key 'BACK'" in output
assert " - [Tool Call]: Tapped element at [500, 600]" in output
def test_build_plan_and_history_repaired_result():
plan = "- [ ] Subgoal 1"
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "2.5s",
"summary": "Tapped button with repair",
"action_taken": [{"action": "click"}],
"last_execution_result": {
"execution": [
{
"action": "click",
"attempts": ["pre-validation failed"],
"repair": ("Tapped center to wake controls and then tapped target"),
}
],
"status": "success",
"repair_status": "fixed",
},
}
]
output = build_plan_and_history(plan, steps, "default", last_n_detailed=1)
assert " * [Validator Execution Result]: Action executed." not in output
assert " * [Result]: Repaired: Tapped center to wake controls and then tapped target" in output
def test_get_recent_subgoal_hashes_robust_milestone_exclusion(tmp_path):
# Scenario:
# 1. Milestone 1 is completed (hash_completed_1).
# 2. We had a failed attempt 'hash_failed_old' during Milestone 1.
# 3. Milestone 2 is completed (hash_completed_2).
# 4. We are now working on Milestone C (hash_active_c).
# 5. Milestone C had two previous failed renamed versions: Failed Attempt A and Failed Attempt B.
# 6. subgoal_hash_chain.json maps: A -> B -> C.
base_dir = tmp_path
notes_dir = base_dir / "notes"
notes_dir.mkdir(parents=True, exist_ok=True)
chain_path = notes_dir / "subgoal_hash_chain.json"
hash_completed_1 = hashlib.md5(b"Completed Milestone 1").hexdigest()
hash_completed_2 = hashlib.md5(b"Completed Milestone 2").hexdigest()
hash_active_c = hashlib.md5(b"Active Milestone C").hexdigest()
hash_failed_old = hashlib.md5(b"Failed Attempt Old").hexdigest()
hash_failed_a = hashlib.md5(b"Failed Attempt A").hexdigest()
hash_failed_b = hashlib.md5(b"Failed Attempt B").hexdigest()
# Write the hash chain representing: A -> B -> C
import json
chain_data = {hash_failed_a: hash_failed_b, hash_failed_b: hash_active_c}
chain_path.write_text(json.dumps(chain_data), encoding="utf-8")
steps = [
# Steps from Completed Milestone 1
{"step_id": "s1", "extra_metadata": {"subgoal_hash": hash_completed_1}},
# Old failed attempt during Milestone 1
{"step_id": "s2", "extra_metadata": {"subgoal_hash": hash_failed_old}},
# Steps from Completed Milestone 2 (Most recent completed milestone)
{"step_id": "s3", "extra_metadata": {"subgoal_hash": hash_completed_2}},
{"step_id": "s4", "extra_metadata": {"subgoal_hash": hash_completed_2}},
# Steps from Failed Attempt A (Part of the active task slot's past renames)
{"step_id": "s5", "extra_metadata": {"subgoal_hash": hash_failed_a}},
{"step_id": "s6", "extra_metadata": {"subgoal_hash": hash_failed_a}},
# Steps from Failed Attempt B (Part of the active task slot's past renames)
{"step_id": "s7", "extra_metadata": {"subgoal_hash": hash_failed_b}},
{"step_id": "s8", "extra_metadata": {"subgoal_hash": hash_failed_b}},
# Steps from Active Milestone C
{"step_id": "s9", "extra_metadata": {"subgoal_hash": hash_active_c}},
]
# Test raw transitive alias resolver
from artemis.utils.task_tree import get_all_subgoal_aliases
aliases = get_all_subgoal_aliases(hash_active_c, base_dir)
assert aliases == {hash_active_c, hash_failed_b, hash_failed_a}
keep_hashes = get_recent_subgoal_hashes(steps, hash_active_c, base_dir)
# Should keep:
# 1. The current active subgoal (hash_active_c)
assert hash_active_c in keep_hashes
# 2. The failed/renamed subgoals during active slot (hash_failed_b, hash_failed_a) - resolved transitively via chain
assert hash_failed_b in keep_hashes
assert hash_failed_a in keep_hashes
# 3. The single most recent completed subgoal (hash_completed_2) for continuity context
assert hash_completed_2 in keep_hashes
# Should prune:
# 4. Older completed subgoals (hash_completed_1)
assert hash_completed_1 not in keep_hashes
# 5. Older failed subgoals from previously completed milestones (hash_failed_old)
assert hash_failed_old not in keep_hashes
def test_build_plan_and_history_for_failure_analyzer():
plan_with_subgoals = """- [/] Goal 1
- [x] Subtask 1.1
- [/] Subtask 1.2"""
steps = [
{
"step_id": "step_1",
"step_number": 1,
"relative_time": "12.3s",
"summary": "Tapped full screen",
"action_taken": [{"action": "click", "target_text": "Fullscreen"}],
"operator_raw_thinking": "Let's tap it",
"operator_native_thinking": "Thinking to tap",
"last_execution_result": {"status": "failed"},
"interleaved_events": [
{"type": "thought", "content": "I should find fullscreen icon."},
{
"type": "tool_call",
"name": "safety_net_validation",
"args": {"target": "Fullscreen"},
"result": [
False,
"TARGET_DISAPPEARED",
"Target button is not visible",
],
},
],
}
]
# Test with subgoals and for_failure_analyzer=True
output_analyzer_with_plan = build_plan_and_history(
plan_with_subgoals,
steps,
"default",
last_n_detailed=1,
for_failure_analyzer=True,
)
assert "--- Task Plan ---" in output_analyzer_with_plan
assert (
"*(Note: Provided for context only. Do not execute the remaining"
" plan.)*" in output_analyzer_with_plan
)
assert "--- Execution History ---" in output_analyzer_with_plan
assert (
"- **Step 1 (Most Recent Step (Failed to execute, this is the step you"
" need to focus on and repair), Start: 12.3s)**" in output_analyzer_with_plan
)
assert "[Operator Decision Loop]" in output_analyzer_with_plan
assert "I should find fullscreen icon." in output_analyzer_with_plan
assert (
"* [Planned Action]: Tapped 'Fullscreen' at None (Intercepted by"
" Pre-Execution Safety Net)" in output_analyzer_with_plan
)
# Test with empty plan and for_failure_analyzer=True (should completely omit plan block)
output_analyzer_empty_plan = build_plan_and_history(
"", steps, "default", last_n_detailed=1, for_failure_analyzer=True
)
assert "--- Task Plan ---" not in output_analyzer_empty_plan
assert (
"*(Note: Provided for context only. Do not execute the remaining"
" plan.)*" not in output_analyzer_empty_plan
)
assert "--- Execution History ---" in output_analyzer_empty_plan