droid-mcp-shell-core/io.droidmcp.shell/GetTopWindowTool

GetTopWindowTool

class GetTopWindowTool(shell: ShellBackend) : McpTool

Foreground activity/window from dumpsys window mCurrentFocus and dumpsys window mFocusedApp. This is the standard way to get the foreground package on devices where Accessibility isn't enabled — it's what the LLM-agent should call when it just needs "what app is on top right now" without driving the UI. Read-only; takes no parameters.

Privilege: requires a working ShellBackend.

On success the result map carries package_name, activity, window_class, and display_id (any may be null if not present in the dumpsys output).

Constructors

GetTopWindowTool

constructor(shell: ShellBackend)

Properties

annotations

open override val annotations: ToolAnnotations

description

open override val description: String

name

open override val name: String

parameters

open override val parameters: List<ToolParameter>

Functions

execute

open suspend override fun execute(params: Map<String, Any>): ToolResult