Human Auth Location

Use this when an app needs the user's real GPS location but the Agent Phone has no real GPS.

When to Trigger

• App requests location permission and shows "location not available" or defaults to wrong location.
• App needs "nearby" results but the emulator has no GPS fix.
• Capability Probe detects location / ACCESS_FINE_LOCATION activity.

How to Call

request_human_auth(
  capability: "location",
  instruction: "Please share your current GPS location for [purpose].",
  uiTemplate: {
    allowLocationAttachment: true,
    requireArtifactOnApprove: true,
    title: "Location Needed",
    summary: "Share your current location coordinates."
  }
)

After You Receive the Artifact

The artifact is a JSON file with lat and lon fields. Read it first: read(<artifact_path>).