Function run_agent

kernel.py:41–81

Main agent loop: Perceive -> Reason -> Act Args: goal: The task to accomplish max_steps: Maximum steps before stopping (default from config)

(goal: str, max_steps: int = None)

def run_agent(goal: str, max_steps: int = None) -> None:
    """
    Main agent loop: Perceive -> Reason -> Act

    Args:
        goal: The task to accomplish
        max_steps: Maximum steps before stopping (default from config)
    """
    if max_steps is None:
        max_steps = Config.MAX_STEPS

    print(f"🚀 Android Action Kernel Started")
    print(f"📋 Goal: {goal}")
    print(f"🤖 Provider: {Config.LLM_PROVIDER} ({Config.get_model()})")

    # Initialize LLM provider
    llm = get_llm_provider()
    action_history: List[Dict[str, Any]] = []

    for step in range(max_steps):
        print(f"\n--- Step {step + 1}/{max_steps} ---")

        # 1. Perception: Capture screen state
        print("👀 Scanning Screen...")
        screen_context = get_screen_state()

        # 2. Reasoning: Get LLM decision
        print("🧠 Thinking...")
        decision = llm.get_decision(goal, screen_context, action_history)
        print(f"💡 Decision: {decision.get('reason', 'No reason provided')}")

        # 3. Action: Execute the decision
        execute_action(decision)

        # Track action history for context
        action_history.append(decision)

        # Wait for UI to update
        time.sleep(Config.STEP_DELAY)

    print("\n⚠️ Max steps reached. Task may be incomplete.")


def main():