feat: add agentic video analysis and clarify action results

Report device actions as dispatched and preserve full failure details. Route
Flash through McpActionExecutor and use ToolFailure across helper tools and
agent loops instead of inferring failure from response text.

Require model-provided descriptions for coordinate targets. Keep observed
element metadata separate from those descriptions in safety checks, visual
summaries, history, and frontend labels.

Add Gemini Interactions API video analysis with configurable processing mode,
chunk size, and timeouts. Centralize Google provider capabilities and token
usage normalization, and update google-genai to 2.22.0.

Preserve system instructions on follow-up interactions, replan pending chunks
when falling back to static processing, and reject unanswered native video
and audio segments instead of caching placeholder results. Keep helper-tool
failure status intact through history tools and committee calls.

Validation: 1,762 Python unit tests passed (3 skipped), 40 frontend formatter
tests passed, and the production UI build completed. Ruff lint, formatting,
the quality ratchet, and git diff checks passed.
This commit is contained in:
somew1nd committed 2026-09-08 17:05:54 -07:00
1 parent 611d1a0947
commit a45daf23f8
120 files changed
+6301 -1710

No files matched your search

+86 -1
View File
@@ -532,7 +532,7 @@ def test_build_plan_and_history_fast_action_burst():
"* [Planned Fast-Action Burst]: 3 actions fired back to back without the"
" safety net" in output
)
assert " 1. Tapped element at [500, 900] (executed)" in output
assert " 1. Tapped element at [500, 900] (dispatched)" in output
assert " 2. Tapped 'Skip' at [880, 120] (FAILED: Error: tap rejected)" in output
assert " 3. Pressed key 'BACK' (skipped)" in output
assert (
@@ -751,3 +751,88 @@ def test_format_action_clean_reads_flash_arguments_and_maps_manage_app():
)
== "Tapped 'Save' at [1, 2]"
)
def test_format_action_clean_marks_self_described_coordinate_targets():
"""A coordinate target's label is the model's own description, and every
later reader sees it marked as such; an index target's observed element
text carries no marker."""
from artemis.utils.task_tree import SELF_DESCRIBED_MARKER, format_action_clean
assert SELF_DESCRIBED_MARKER == "(self-described)"
assert (
format_action_clean(
{"action": "tap", "coordinates": [540, 1440], "target_description": "play button"}
)
== "Tapped 'play button' (self-described) at [540, 1440]"
)
# Observed text outranks the description when both are present, unmarked.
assert (
format_action_clean(
{
"action": "tap",
"coordinates": [1, 2],
"target_text": "Play",
"target_description": "play button",
}
)
== "Tapped 'Play' at [1, 2]"
)
assert (
format_action_clean(
{
"action": "long_press_on",
"coordinates": [1, 2],
"duration": 1500,
"target_description": "app icon",
}
)
== "Long pressed 'app icon' (self-described) at [1, 2] for 1500ms"
)
assert (
format_action_clean(
{
"action": "focus_and_input_text",
"coordinates": [3, 4],
"text": "hello",
"target_description": "search box",
}
)
== "Inputted 'hello' into 'search box' (self-described) at [3, 4]"
)
assert (
format_action_clean(
{
"action": "swipe",
"coordinates": [100, 500, 900, 500],
"duration": 800,
"target_description": "brightness knob",
}
)
== "Swiped 'brightness knob' (self-described) from [100, 500] to [900, 500] over 800ms"
)
# Flash keeps the description under ``args``; it is read from there too.
assert (
format_action_clean(
{
"action": "click",
"coordinates": [320, 399],
"args": {"target": [320, 399], "target_description": "skip ad"},
}
)
== "Tapped 'skip ad' (self-described) at [320, 399]"
)
assert format_action_clean(
{
"action": "click_sequence",
"coordinates": [[500, 280], [885, 362]],
"target_descriptions": ["video body", "skip button"],
}
) == (
"Tapped sequence of targets: 'video body' (self-described) at [500, 280],"
" 'skip button' (self-described) at [885, 362]"
)
# Unnamed targets stay unnamed: no marker without a description.
assert format_action_clean({"action": "tap", "coordinates": [1, 2]}) == (
"Tapped element at [1, 2]"
)