Files
Artemis-Eapil/artemis/tools/mobile/read_logs.py
somew1nd a45daf23f8 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.
2026-09-08 17:05:54 -07:00

117 lines
4.0 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.
from typing import Any
from langchain_core.tools.base import BaseTool
from pydantic import BaseModel, Field
from artemis.core.tool_failure import ToolFailure
from artemis.context import ArtemisContext
from artemis.data_engine.trace import trace_langchain_tool
from artemis.drivers.base import BaseDeviceDriver
from artemis.graph.state import State
from artemis.tools.base import ArtemisTool, ToolCategory
from artemis.tools.mobile.log_utils import fetch_and_filter_logs
from artemis.utils.logger import get_logger
logger = get_logger(__name__)
class ReadLogsArgs(BaseModel):
"""Arguments schema for read_logs tool."""
lines: int | None = Field(
default=200,
description=(
"Number of recent log lines to read. Default is 200. Use larger"
" numbers only if necessary."
),
)
since_time: str | None = Field(
default=None,
description=(
"Target timestamp in 'MM-DD HH:MM:SS.ms' format OR relative seconds"
" (e.g., '15.5') to read logs since. If provided, we will try to"
" fetch logs starting from this time."
),
)
until_time: str | None = Field(
default=None,
description=(
"Target timestamp in 'MM-DD HH:MM:SS.ms' format OR relative seconds"
" (e.g., '20.0') to read logs until. If provided, we will filter"
" logs up to this time."
),
)
READ_LOGS_DOCSTRING = (
"[DIAGNOSTIC] Fetches raw Android logs.\n\n"
"- Use when: You need to scan logs for a time window or see the sequence"
" of events.\n"
"- Input: lines (int, optional): Number of lines to read (default 200)."
" since_time (str, optional): Timestamp or relative seconds to read since."
" until_time (str, optional): Timestamp or relative seconds to read until.\n"
"- Output: Raw log text."
)
class ReadLogsTool(ArtemisTool):
"""Universal tool for fetching raw Android logs."""
def __init__(self, category: ToolCategory = "diagnostic"):
super().__init__(
name="read_logs",
description=READ_LOGS_DOCSTRING,
args_schema=ReadLogsArgs,
category=category,
)
# pylint: disable=too-many-arguments,too-many-positional-arguments
async def execute(
self,
driver: BaseDeviceDriver | None = None, # pylint: disable=unused-argument
ctx: ArtemisContext | None = None,
lines: int | None = 200,
since_time: str | None = None,
until_time: str | None = None,
tool_call_id: str | None = None, # pylint: disable=unused-argument
state: State | None = None, # pylint: disable=unused-argument
**kwargs: Any,
) -> str:
try:
num_lines = 200 if lines is None else lines
logs = fetch_and_filter_logs(
ctx=ctx,
lines=num_lines,
since_time=since_time,
until_time=until_time,
)
return logs
except Exception as e: # pylint: disable=broad-exception-caught
logger.error(f"Failed to read logs: {e}")
return ToolFailure(f"Failed to read logs: {e}")
# Universal tool instance & aliases
read_logs = ReadLogsTool()
ReadLogs = ReadLogsTool
ReadLogsToolAlias = ReadLogsTool
def get_read_logs_tool(ctx: ArtemisContext) -> BaseTool:
"""Exports read_logs as a LangChain BaseTool."""
return trace_langchain_tool(read_logs.to_langchain_tool(ctx), ctx)