Files
Artemis-Eapil/artemis/tools/index.py
T
somew1nd 206a9ce921 feat: initial release of ARTEMIS Android Agent & Automation Platform
ARTEMIS is an autonomous multimodal Android agent and mobile UI automation
platform engineered for physical devices and emulators. It combines state-of-the-art
multimodal Vision-Language Models (VLMs) with hierarchical closed-loop planning,
resilient self-healing, and deep Android subsystem integration.

Key Features & Architectural Highlights:
- Dual-Engine Orchestration:
  * Pro Engine: Multi-agent closed-loop (Planner -> Operator -> Validator/Failure Analyzer -> Summarizer) powered by LangGraph.
  * Flash Engine: Ultra-fast reactive loop for deterministic, low-latency UI execution (<35 steps).
- Multimodal Perception & Grounding:
  * Hybrid visual screenshot grounding, real-time OCR extraction, and XML accessibility hierarchy parsing.
  * Dynamic-First, Coordinate-Fallback locating strategy for maximum resilience against UI drift.
- Autonomous Self-Healing & Diagnostics:
  * Failure analyzer and safety net for popup dismissal, crash recovery, and auto-retry.
  * Diagnostic sub-agents for log analysis, video recording inspection, and object detection.
- Unified CLI & Python SDK:
  * Rich CLI with commands: init, doctor, run, trace, batch, bench, server, and mcp.
  * Fluent Python SDK with Pydantic structured output models and package locking.
- Multi-Provider LLM Architecture:
  * Support for Google Gemini, OpenAI, Anthropic Claude, Vertex AI, OpenRouter, xAI Grok, and local endpoints (Ollama/vLLM).
  * Centralized configuration in config/artemis.jsonc.
- Native MCP & Observability:
  * Model Context Protocol (MCP) server endpoints for AI IDEs.
  * Full trace recording with before/after screenshots, action overlays, and execution replays.

Change-Id: I430b93ee2b76b54cc5a3c6eeccd15d2cf29830a1
2026-08-13 11:46:47 -07:00

53 lines
1.8 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 langchain_core.tools import BaseTool
from artemis.context import ArtemisContext
from artemis.data_engine.trace import trace_langchain_tool
from artemis.tools.tool_wrapper import CompositeToolWrapper, ToolWrapper
def get_tools_from_wrappers(
ctx: "ArtemisContext",
wrappers: list[ToolWrapper],
) -> list[BaseTool]:
"""Instantiate and wrap LangChain tools from a list of ToolWrappers."""
tools: list[BaseTool] = []
for wrapper in wrappers:
if isinstance(wrapper, CompositeToolWrapper):
comp_tools = wrapper.composite_tools_fn_getter(ctx)
for t in comp_tools:
tools.append(trace_langchain_tool(t, ctx))
continue
t = wrapper.tool_fn_getter(ctx)
tools.append(trace_langchain_tool(t, ctx))
return tools
def get_tool_by_name(name: str, tools: list[BaseTool]) -> BaseTool | None:
"""Get a tool by name, stripping any prefixes like 'default_api:'."""
normalized_name = name
if ":" in normalized_name:
normalized_name = normalized_name.split(":")[-1]
for t in tools:
t_name = t.name
if ":" in t_name:
t_name = t_name.split(":")[-1]
if t_name == normalized_name:
return t
return None