android-mock-location-mcp 0.2.1 → 0.3.0

package/README.md

@@ -1,20 +1,18 @@
 # MCP Server — android-mock-location-mcp
 
-MCP server that exposes 9 tools for controlling Android device GPS location. Connects to an Android agent app over TCP (via ADB port forwarding) and supports geocoding and street-level routing through configurable providers.
+MCP server that exposes 11 tools for controlling Android emulator GPS location. Sets mock locations via `adb emu geo fix` and supports geocoding and street-level routing through configurable providers.
 
 See the [root README](../README.md) for project overview and quick start.
 
 ## Installation
 
-**npx (no install):**
-```bash
-npx android-mock-location-mcp
-```
+The server is launched automatically by your MCP client — you don't run it directly. The installation method determines how the client finds and starts it.
+
+**npx (no install needed):** Use `npx -y android-mock-location-mcp` as the command in your MCP client config. The client will download and run it automatically.
 
-**Global install:**
+**Global install:** Pre-install the package so the client can launch it without download delay:
 ```bash
 npm install -g android-mock-location-mcp
-android-mock-location-mcp
 ```
 
 **Build from source:**
@@ -22,9 +20,12 @@ android-mock-location-mcp
 cd server
 npm install
 npm run build
-npm start
 ```
 
+> **Updating:** `npx` caches packages after the first download. To force an update, temporarily change the command in your MCP client config to `npx -y android-mock-location-mcp@latest` and restart the client.
+
+See the [Configuration](#configuration) section below for how to set up your MCP client to launch the server.
+
 ## Configuration
 
 ### Environment Variables
@@ -35,6 +36,8 @@ npm start
 | `GOOGLE_API_KEY` | Google Places + Routes API key | When `PROVIDER=google` |
 | `MAPBOX_ACCESS_TOKEN` | Mapbox Geocoding + Directions access token | When `PROVIDER=mapbox` |
 
+Provider selection is resolved once at server startup. Changing `PROVIDER` or API keys requires restarting the MCP client (which restarts the server).
+
 Set environment variables in your MCP client configuration:
 
 <details>
@@ -100,7 +103,7 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o
 ```
 </details>
 
-After editing the config, restart the MCP server and Claude Desktop for changes to take effect.
+After editing the config, restart Claude Desktop to apply the changes (this restarts the MCP server automatically).
 
 <details>
 <summary><b>Claude Code (default OSM provider)</b></summary>
@@ -141,7 +144,7 @@ claude mcp add android-mock-location-mcp \
 <details>
 <summary><b>Claude Code — switching providers</b></summary>
 
-To switch from one provider to another (e.g. `osm` → `google`), remove and re-add the server with new env vars, then restart the server and Claude Code:
+To switch from one provider to another (e.g. `osm` → `google`), remove and re-add the server with new env vars, then restart Claude Code:
 
 ```bash
 # 1. Remove existing server
@@ -154,10 +157,10 @@ claude mcp add android-mock-location-mcp \
   -e GOOGLE_API_KEY=$GOOGLE_API_KEY \
   -- npx -y android-mock-location-mcp
 
-# 3. Restart the MCP server and Claude Code
+# 3. Restart Claude Code (this restarts the MCP server automatically)
 ```
 
-Environment variables are baked into the MCP server config at initialization time. Changing providers requires restarting the server.
+Provider selection is resolved once at server startup, so restarting is required for changes to take effect.
 </details>
 
 ### Providers
@@ -178,7 +181,7 @@ Google and Mapbox providers produce better results than the default OSM provider
 
 ### `geo_list_devices`
 
-List connected Android devices via ADB.
+List connected Android emulators via ADB.
 
 No parameters.
 
@@ -186,24 +189,23 @@ No parameters.
 
 ### `geo_connect_device`
 
-Connect to an Android device for mock location control. Automatically grants permissions, selects the app as mock location provider, starts the agent service, sets up ADB port forwarding, and opens a TCP socket.
+Connect to an Android emulator for mock location control. Only emulators are supported (e.g. `emulator-5554`). Locations are set via the emulator's `geo fix` command.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `deviceId` | string | yes | Device serial from `geo_list_devices`, e.g. `emulator-5554` |
+| `deviceId` | string | yes | Emulator serial from `geo_list_devices`, e.g. `emulator-5554` |
 
 ---
 
 ### `geo_set_location`
 
-Set device GPS to coordinates or any place name/address. Geocodes place names via the configured provider.
+Set emulator GPS to coordinates or any place name/address. Geocodes place names via the configured provider.
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
 | `lat` | number | no | — | Latitude (-90 to 90) |
 | `lng` | number | no | — | Longitude (-180 to 180) |
 | `place` | string | no | — | Place name or address, e.g. `'Times Square'`, `'Tokyo Station'` |
-| `accuracy` | number | no | `3` | GPS accuracy in meters |
 
 Provide either `place` or both `lat`/`lng`.
 
@@ -227,7 +229,7 @@ Simulate movement along a route between two points at a given speed. Routes foll
 
 Provide either `from`/`to` (place names) or `fromLat`/`fromLng`/`toLat`/`toLng` (coordinates) for each endpoint.
 
-**Starting location auto-resolve:** If no `from`/`fromLat`/`fromLng` is provided, the tool automatically tries (in order): the last mock location, the device's real GPS position via `geo_get_location`, or returns an error asking the user for their starting location.
+**Starting location auto-resolve:** If no `from`/`fromLat`/`fromLng` is provided, the tool automatically tries (in order): the last mock location, the emulator's current GPS position via `geo_get_location`, or returns an error asking the user for their starting location.
 
 #### Routing Profiles
 
@@ -241,6 +243,30 @@ The AI should select `profile` based on user intent (e.g. "walk to" → `foot`,
 
 ---
 
+### `geo_simulate_multi_stop`
+
+Simulate movement along a multi-stop route (e.g. delivery route, rideshare pickups). Routes between consecutive waypoints follow real streets. Each waypoint can have a dwell time (time spent stationary at the stop before continuing). Runs as one continuous 1 Hz simulation with no gaps between legs.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `waypoints` | array | yes | — | Ordered list of waypoints (min 2). Each: `{ lat?, lng?, place?, dwellSeconds? }` |
+| `speedKmh` | number | no | `60` | Travel speed between waypoints (km/h) |
+| `trafficMultiplier` | number | no | `1.0` | Traffic slowdown factor (e.g. `1.5` = 50% slower) |
+| `profile` | enum | no | `car` | Routing profile: `car`, `foot`, or `bike` |
+
+Each waypoint object:
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `lat` | number | no | — | Waypoint latitude |
+| `lng` | number | no | — | Waypoint longitude |
+| `place` | string | no | — | Waypoint place name or address |
+| `dwellSeconds` | number | no | `0` | Time to stay at this waypoint before continuing (seconds) |
+
+Provide either `place` or both `lat`/`lng` per waypoint. If the first waypoint has no coordinates or place, the tool auto-resolves from the current mock location or emulator GPS position.
+
+---
+
 ### `geo_simulate_jitter`
 
 Simulate GPS noise/jitter at a location for testing accuracy handling.
@@ -291,6 +317,32 @@ Provide either `place` or both `lat`/`lng`.
 
 ---
 
+### `geo_replay_gpx_kml`
+
+Replay a GPX or KML track file on the emulator. Auto-detects format from the XML content.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `fileContent` | string | no* | — | Raw GPX or KML file content (XML string) |
+| `filePath` | string | no* | — | Absolute path to a GPX or KML file on the host |
+| `speedMultiplier` | number | no | `1.0` | Playback speed multiplier for time-based replay (e.g. `2.0` = 2x faster) |
+| `speedKmh` | number | no | `60` | Travel speed for distance-based replay (km/h) |
+
+*Provide either `fileContent` or `filePath`.
+
+#### Replay Modes
+
+| Mode | When used | Speed control |
+|------|-----------|---------------|
+| Time-based | GPX files with timestamps on ≥80% of trackpoints | `speedMultiplier` — preserves original speed profile |
+| Distance-based | KML files, or GPX without timestamps | `speedKmh` — constant speed along the track |
+
+**GPX support:** Extracts `<trkpt>` elements from `<trk>/<trkseg>` with optional `<ele>` (elevation) and `<time>` (timestamp).
+
+**KML support:** Extracts `<coordinates>` from `<LineString>` elements. Coordinate format is `lng,lat,ele` tuples separated by whitespace.
+
+---
+
 ### `geo_stop`
 
 Stop any active location simulation.
@@ -309,22 +361,35 @@ No parameters.
 
 ### `geo_get_location`
 
-Get the device's current real GPS location (last known position from the device's location sensors). Use this to determine where the device physically is before simulating a route.
+Get the emulator's current GPS location (last known position from the emulator's location providers). Reads the location via `adb shell dumpsys location`. Use this to determine where the emulator is before simulating a route.
 
 No parameters.
 
-Returns the device's latitude and longitude if a recent GPS fix is available, along with `accuracy` (horizontal accuracy in meters) and `ageMs` (milliseconds since the fix was obtained) when provided by the device. If the device has no location fix, the tool returns an error message — in that case, ask the user for their current location.
+Returns the emulator's latitude and longitude if a recent GPS fix is available, along with `accuracy` (horizontal accuracy in meters) when provided. If the emulator has no location fix, the tool returns an error message — in that case, ask the user for their current location.
+
+## How It Works
+
+The server sets emulator GPS location using `adb emu geo fix`, which updates the emulator's stored GPS state. The command format is:
+
+```text
+geo fix <longitude> <latitude> [<altitude> [<satellites> [<velocity>]]]
+```
+
+Unlike `geo nmea` (which injects one-shot NMEA sentences), `geo fix` updates the emulator's internal state so the position persists across the emulator's 1 Hz GPS update loop.
+
+The `geo fix` command is processed directly by the emulator's GPS simulation layer.
 
 ## Source Structure
 
 | File | Purpose |
 |------|---------|
-| `src/index.ts` | MCP server setup, all 9 tool definitions with Zod schemas |
-| `src/adb.ts` | ADB command execution with timeouts, device setup, agent install check |
-| `src/device.ts` | TCP socket to agent, connection state machine, request/response matching |
+| `src/index.ts` | MCP server setup, all 11 tool definitions with Zod schemas |
+| `src/emulator.ts` | Emulator connection management, location setting via `geo fix` |
+| `src/adb.ts` | ADB command execution with timeouts, emulator validation |
 | `src/geocode.ts` | Geocoding providers: Nominatim, Google, Mapbox |
 | `src/routing.ts` | Routing providers: OSRM, Google Routes API, Mapbox Directions |
-| `src/geo-math.ts` | Haversine distance, forward bearing calculation |
+| `src/gpx-kml.ts` | GPX/KML file parsing for track replay |
+| `src/geo-math.ts` | Haversine distance calculation |
 | `src/fetch-utils.ts` | Shared `fetchWithTimeout` helper |
 
 ## Development
@@ -340,7 +405,8 @@ The server communicates via stdio (MCP protocol). To test interactively, use the
 
 ## Known Limitations
 
-- **Single device only.** The server connects to one Android device at a time. Calling `geo_connect_device` with a different serial disconnects the previous device and stops any active simulation. Controlling multiple devices simultaneously is not supported.
+- **Emulators only.** The server uses `adb emu geo fix` which only works with Android emulators. Physical devices are not supported.
+- **Single emulator.** The server connects to one emulator at a time. Calling `geo_connect_device` with a different serial disconnects the previous one and stops any active simulation.
 - **Single simulation.** Only one simulation (route, jitter, or geofence) runs at a time. Starting a new one stops the previous.
 
 See also: provider-specific limitations in the [Providers](#providers) table above.

package/dist/adb.d.ts

@@ -1,30 +1,14 @@
-export declare const AGENT_PACKAGE = "com.ms.square.geomcpagent";
-export declare const AGENT_PORT = 5005;
-/** Device-scoped synchronous ADB command. Always validates deviceId and applies timeout. */
+interface ExecError extends Error {
+    stderr?: string;
+    status?: number | null;
+}
+export declare function isExecError(err: unknown): err is ExecError;
+/** Check if a device ID matches the emulator serial pattern. */
+export declare function isEmulator(deviceId: string): boolean;
+/** Emulator-scoped synchronous ADB command. Validates deviceId and applies timeout. */
 export declare function adbDevice(deviceId: string, args: string[], timeoutMs?: number): string;
 /** Global asynchronous ADB command (no -s flag). */
 export declare function adb(args: string[], timeoutMs?: number): Promise<string>;
 /** List connected ADB devices. Returns raw `adb devices -l` output. */
 export declare function listDevices(): Promise<string>;
-/**
- * Check whether the agent APK is installed on the device.
- * Returns true if installed, false if not installed.
- * Throws if the ADB command fails for other reasons (device offline, unauthorized, etc.).
- */
-export declare function isAgentInstalled(deviceId: string): boolean;
-/**
- * Ensure the device is set up for mock location: grant location permissions
- * and set this app as the mock location provider via AppOps.
- * All commands are idempotent — safe to call on every connection attempt.
- */
-export declare function ensureDeviceSetup(deviceId: string): void;
-/**
- * Start the MockLocationService directly via ADB.
- * The service is exported, so it can be started without launching the Activity.
- */
-export declare function startAgentService(deviceId: string): void;
-/**
- * Set up ADB port forwarding for the agent TCP socket.
- * Synchronous — throws on failure with stderr context.
- */
-export declare function adbForward(deviceId: string): void;
+export {};

package/dist/adb.js

@@ -1,24 +1,29 @@
-// ── ADB command execution ────────────────────────────────────────────────────
+// ── ADB command execution (emulator-only) ────────────────────────────────────
 import { execFileSync, execFile } from "node:child_process";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 // ── Constants ────────────────────────────────────────────────────────────────
-export const AGENT_PACKAGE = "com.ms.square.geomcpagent";
-export const AGENT_PORT = 5005;
 const ADB_TIMEOUT_MS = 10_000;
-// Covers emulator serials, USB serials, IPv4:port, and bracketed IPv6:port (e.g. [::1]:5555)
-const DEVICE_ID_PATTERN = /^(\[[a-fA-F0-9.:]+\](:\d+)?|[a-zA-Z0-9._:\-]+)$/;
-function isExecError(err) {
-    return err instanceof Error && "stderr" in err;
+/** Only emulator serials are accepted (e.g. emulator-5554). */
+const EMULATOR_ID_PATTERN = /^emulator-\d+$/;
+export function isExecError(err) {
+    if (!(err instanceof Error) || !("stderr" in err))
+        return false;
+    const { stderr } = err;
+    return stderr === undefined || typeof stderr === "string";
 }
 // ── Validation ───────────────────────────────────────────────────────────────
 function validateDeviceId(deviceId) {
-    if (!DEVICE_ID_PATTERN.test(deviceId)) {
-        throw new Error(`Invalid device ID: ${deviceId}`);
+    if (!EMULATOR_ID_PATTERN.test(deviceId)) {
+        throw new Error(`Invalid emulator ID: ${deviceId}. Only Android emulators are supported (e.g. emulator-5554).`);
     }
 }
+/** Check if a device ID matches the emulator serial pattern. */
+export function isEmulator(deviceId) {
+    return EMULATOR_ID_PATTERN.test(deviceId);
+}
 // ── Primitives ───────────────────────────────────────────────────────────────
-/** Device-scoped synchronous ADB command. Always validates deviceId and applies timeout. */
+/** Emulator-scoped synchronous ADB command. Validates deviceId and applies timeout. */
 export function adbDevice(deviceId, args, timeoutMs = ADB_TIMEOUT_MS) {
     validateDeviceId(deviceId);
     return execFileSync("adb", ["-s", deviceId, ...args], {
@@ -39,61 +44,4 @@ export async function adb(args, timeoutMs = ADB_TIMEOUT_MS) {
 export async function listDevices() {
     return adb(["devices", "-l"]);
 }
-/**
- * Check whether the agent APK is installed on the device.
- * Returns true if installed, false if not installed.
- * Throws if the ADB command fails for other reasons (device offline, unauthorized, etc.).
- */
-export function isAgentInstalled(deviceId) {
-    try {
-        const output = adbDevice(deviceId, ["shell", "pm", "path", AGENT_PACKAGE]);
-        return output.includes("package:");
-    }
-    catch (err) {
-        // `pm path` exits with code 1 and empty stderr when the package is not found.
-        // ADB-level failures (device offline, unauthorized) also exit with code 1 but
-        // include an error message on stderr — those should propagate.
-        if (isExecError(err) && err.status === 1 && !err.stderr?.trim()) {
-            return false;
-        }
-        throw err;
-    }
-}
-/**
- * Ensure the device is set up for mock location: grant location permissions
- * and set this app as the mock location provider via AppOps.
- * All commands are idempotent — safe to call on every connection attempt.
- */
-export function ensureDeviceSetup(deviceId) {
-    adbDevice(deviceId, ["shell", "pm", "grant", AGENT_PACKAGE, "android.permission.ACCESS_FINE_LOCATION"]);
-    adbDevice(deviceId, ["shell", "pm", "grant", AGENT_PACKAGE, "android.permission.ACCESS_COARSE_LOCATION"]);
-    adbDevice(deviceId, ["shell", "appops", "set", AGENT_PACKAGE, "android:mock_location", "allow"]);
-}
-/**
- * Start the MockLocationService directly via ADB.
- * The service is exported, so it can be started without launching the Activity.
- */
-export function startAgentService(deviceId) {
-    adbDevice(deviceId, [
-        "shell",
-        "am",
-        "start-foreground-service",
-        "-n",
-        `${AGENT_PACKAGE}/.MockLocationService`,
-    ]);
-}
-/**
- * Set up ADB port forwarding for the agent TCP socket.
- * Synchronous — throws on failure with stderr context.
- */
-export function adbForward(deviceId) {
-    try {
-        adbDevice(deviceId, ["forward", `tcp:${AGENT_PORT}`, `tcp:${AGENT_PORT}`]);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        const stderr = isExecError(err) ? err.stderr?.trim() : undefined;
-        throw new Error(`Failed to set up adb port forwarding for ${deviceId}: ${msg}${stderr ? ` (${stderr})` : ""}`);
-    }
-}
 //# sourceMappingURL=adb.js.map

package/dist/adb.js.map

@@ -1 +1 @@
-{"version":3,"file":"adb.js","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adb.js","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,gFAAgF;AAEhF,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,+DAA+D;AAC/D,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAS7C,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAgB,CAAC;IACpC,OAAO,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC;AAC5D,CAAC;AAED,gFAAgF;AAEhF,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,wBAAwB,QAAQ,8DAA8D,CAC/F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,gFAAgF;AAEhF,uFAAuF;AACvF,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAc,EAAE,SAAS,GAAG,cAAc;IACpF,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE;QACpD,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;AACL,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,SAAS,GAAG,cAAc;IAClE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE;QAClD,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAEhF,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,OAAO,GAAG,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/emulator.d.ts

@@ -0,0 +1,52 @@
+/** Register a callback invoked when the emulator disconnects. */
+export declare function onDisconnect(cb: () => void): void;
+export declare function getConnectedDeviceId(): string | null;
+export declare function isConnected(): boolean;
+/**
+ * Connect to an emulator by device ID.
+ * Validates the emulator is reachable via ADB.
+ */
+export declare function connectEmulator(deviceId: string): void;
+export interface LocationParams {
+    lat: number;
+    lng: number;
+    altitude?: number;
+    /** Speed in meters per second. Converted to knots for `geo fix`. */
+    speed?: number;
+}
+/**
+ * Set mock location on the connected emulator via `geo fix`.
+ *
+ * `geo fix` updates the emulator's stored GPS state, so the 1 Hz
+ * PassiveGpsUpdater loop keeps broadcasting the new position.
+ */
+export declare function setLocation(params: LocationParams): void;
+export interface EmulatorLocation {
+    lat: number;
+    lng: number;
+    accuracy?: number;
+}
+/**
+ * Parse a Location line from `dumpsys location` output.
+ *
+ * Android's Location.toString() format (API 26+):
+ *   Location[gps 37.421998,-122.084000 hAcc=20.0 ...]
+ *   Location[fused 37.421998,-122.084000 acc=5.0 ...]
+ *
+ * We extract lat, lng and optional accuracy (hAcc= or acc=).
+ */
+export declare function parseLocationLine(line: string): EmulatorLocation | null;
+/**
+ * Get the emulator's current GPS location via `adb shell dumpsys location`.
+ *
+ * Parses the "Last Known Locations" section from the location service dump
+ * and returns the GPS provider's last fix. Falls back to the fused provider
+ * if GPS is not available.
+ *
+ * Returns null if no location is available.
+ */
+export declare function getLocation(): EmulatorLocation | null;
+/** Initialize emulator module. No-op — no background connections needed. */
+export declare function initEmulator(): void;
+/** Shut down emulator module — clean up state. */
+export declare function shutdownEmulator(): void;

package/dist/emulator.js

@@ -0,0 +1,175 @@
+// ── Emulator location control via `geo fix` ──────────────────────────────────
+//
+// Sets mock locations on the emulator using `adb emu geo fix` which updates
+// the emulator's stored GPS state.  Unlike `geo nmea`, `geo fix` survives the
+// emulator's 1 Hz PassiveGpsUpdater loop that re-sends from stored state.
+//
+// Format: geo fix <longitude> <latitude> [<altitude> [<satellites> [<velocity>]]]
+//   - longitude/latitude in decimal degrees (longitude FIRST)
+//   - altitude in meters
+//   - satellites count (integer)
+//   - velocity in knots
+import { adbDevice, isExecError } from "./adb.js";
+// ── State ────────────────────────────────────────────────────────────────────
+let connectedDeviceId = null;
+let disconnectCallback = null;
+// ── Public API ───────────────────────────────────────────────────────────────
+/** Register a callback invoked when the emulator disconnects. */
+export function onDisconnect(cb) {
+    disconnectCallback = cb;
+}
+export function getConnectedDeviceId() {
+    return connectedDeviceId;
+}
+export function isConnected() {
+    return connectedDeviceId !== null;
+}
+/**
+ * Connect to an emulator by device ID.
+ * Validates the emulator is reachable via ADB.
+ */
+export function connectEmulator(deviceId) {
+    // Disconnect any previously connected emulator first
+    if (connectedDeviceId !== null && connectedDeviceId !== deviceId) {
+        disconnectEmulator();
+    }
+    // Verify the emulator is reachable without side-effects (no location change).
+    // ro.kernel.qemu is "1" on emulators — this confirms ADB connectivity.
+    try {
+        adbDevice(deviceId, ["shell", "getprop", "ro.kernel.qemu"]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const stderr = isExecError(err) ? err.stderr?.trim() : undefined;
+        throw new Error(`Failed to reach emulator ${deviceId}: ${msg}${stderr ? ` (${stderr})` : ""}\n` +
+            "Ensure the emulator is running and ADB is connected.");
+    }
+    connectedDeviceId = deviceId;
+}
+/** Disconnect from the current emulator. */
+function disconnectEmulator() {
+    const wasConnected = connectedDeviceId !== null;
+    connectedDeviceId = null;
+    if (wasConnected) {
+        try {
+            disconnectCallback?.();
+        }
+        catch {
+            // Ignore callback errors
+        }
+    }
+}
+const MS_TO_KNOTS = 1.94384;
+/**
+ * Set mock location on the connected emulator via `geo fix`.
+ *
+ * `geo fix` updates the emulator's stored GPS state, so the 1 Hz
+ * PassiveGpsUpdater loop keeps broadcasting the new position.
+ */
+export function setLocation(params) {
+    if (!connectedDeviceId) {
+        throw new Error("Not connected to an emulator. Call geo_connect_device first with an emulator serial (e.g. emulator-5554).");
+    }
+    // geo fix <longitude> <latitude> [<altitude> [<satellites> [<velocity>]]]
+    const args = [
+        "emu", "geo", "fix",
+        params.lng.toFixed(6),
+        params.lat.toFixed(6),
+    ];
+    const altitude = params.altitude ?? 0;
+    const satellites = 8;
+    args.push(altitude.toFixed(1));
+    args.push(satellites.toString());
+    if (params.speed != null && params.speed > 0) {
+        args.push((params.speed * MS_TO_KNOTS).toFixed(1));
+    }
+    try {
+        adbDevice(connectedDeviceId, args);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        // If ADB fails, the emulator may have been closed
+        disconnectEmulator();
+        throw new Error(`Failed to set location: ${msg}`);
+    }
+}
+/**
+ * Parse a Location line from `dumpsys location` output.
+ *
+ * Android's Location.toString() format (API 26+):
+ *   Location[gps 37.421998,-122.084000 hAcc=20.0 ...]
+ *   Location[fused 37.421998,-122.084000 acc=5.0 ...]
+ *
+ * We extract lat, lng and optional accuracy (hAcc= or acc=).
+ */
+export function parseLocationLine(line) {
+    // Match "Location[<provider> <lat>,<lng>" pattern
+    const coordMatch = line.match(/Location\[\S+\s+(-?[\d.]+),(-?[\d.]+)/);
+    if (!coordMatch)
+        return null;
+    const lat = parseFloat(coordMatch[1]);
+    const lng = parseFloat(coordMatch[2]);
+    if (Number.isNaN(lat) || Number.isNaN(lng))
+        return null;
+    // Try to extract accuracy (hAcc= in newer Android, acc= in older)
+    const accMatch = line.match(/(?:hAcc|acc)=([\d.]+)/);
+    const accuracy = accMatch ? parseFloat(accMatch[1]) : undefined;
+    return { lat, lng, accuracy };
+}
+/**
+ * Get the emulator's current GPS location via `adb shell dumpsys location`.
+ *
+ * Parses the "Last Known Locations" section from the location service dump
+ * and returns the GPS provider's last fix. Falls back to the fused provider
+ * if GPS is not available.
+ *
+ * Returns null if no location is available.
+ */
+export function getLocation() {
+    if (!connectedDeviceId) {
+        throw new Error("Not connected to an emulator. Call geo_connect_device first.");
+    }
+    let output;
+    try {
+        output = adbDevice(connectedDeviceId, ["shell", "dumpsys", "location"]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to query emulator location: ${msg}`);
+    }
+    // Look for "Last Known Locations:" section and parse GPS/fused provider lines
+    const lines = output.split("\n");
+    let inLastKnown = false;
+    let gpsLocation = null;
+    let fusedLocation = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("Last Known Locations:")) {
+            inLastKnown = true;
+            continue;
+        }
+        // End of section: blank line or new non-indented section header
+        if (inLastKnown && (trimmed === "" || (trimmed !== "" && !line.startsWith(" ") && !line.startsWith("\t")))) {
+            break;
+        }
+        if (inLastKnown) {
+            if (trimmed.startsWith("gps:") || trimmed.includes("Location[gps")) {
+                gpsLocation = parseLocationLine(trimmed);
+            }
+            else if (trimmed.startsWith("fused:") || trimmed.includes("Location[fused")) {
+                fusedLocation = parseLocationLine(trimmed);
+            }
+        }
+    }
+    // Prefer GPS, fall back to fused
+    return gpsLocation ?? fusedLocation ?? null;
+}
+/** Initialize emulator module. No-op — no background connections needed. */
+export function initEmulator() {
+    // Nothing to do
+}
+/** Shut down emulator module — clean up state. */
+export function shutdownEmulator() {
+    disconnectEmulator();
+}
+//# sourceMappingURL=emulator.js.map

package/dist/emulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulator.js","sourceRoot":"","sources":["../src/emulator.ts"],"names":[],"mappings":"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"}

package/dist/geo-math.d.ts

@@ -1,4 +1,2 @@
 /** Haversine distance between two points in meters. */
 export declare function haversineDistance(lat1: number, lng1: number, lat2: number, lng2: number): number;
-/** Forward azimuth (bearing) in degrees 0-360 from point 1 to point 2. */
-export declare function computeBearing(lat1: number, lng1: number, lat2: number, lng2: number): number;

package/dist/geo-math.js

@@ -9,12 +9,4 @@ export function haversineDistance(lat1, lng1, lat2, lng2) {
     const a = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLng / 2) ** 2;
     return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
 }
-/** Forward azimuth (bearing) in degrees 0-360 from point 1 to point 2. */
-export function computeBearing(lat1, lng1, lat2, lng2) {
-    const dLng = toRad(lng2 - lng1);
-    const y = Math.sin(dLng) * Math.cos(toRad(lat2));
-    const x = Math.cos(toRad(lat1)) * Math.sin(toRad(lat2)) -
-        Math.sin(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.cos(dLng);
-    return (toDeg(Math.atan2(y, x)) + 360) % 360;
-}
 //# sourceMappingURL=geo-math.js.map