palp 0.2.0

A fast, safe, and friendly mobile screen driver for AI coding agents and developers
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

use thiserror::Error;

#[derive(Error, Debug)]
pub enum PalpError {
    #[error("ADB tool was not found.\nPlease make sure Android SDK platform-tools is installed or set ANDROID_HOME in your environment.")]
    AdbNotFound,

    #[error("No Android phone or emulator was found.\nPlease connect your device via USB or start an emulator, and enable USB Debugging.")]
    NoDeviceConnected,

    #[error("Found multiple connected devices ({count}). Please specify one with --device <ID>.\nAvailable devices:\n{devices}")]
    MultipleDevices { count: usize, devices: String },

    #[error(
        "Device '{0}' is unauthorized. Please unlock your phone and tap 'Allow USB Debugging'."
    )]
    DeviceUnauthorized(String),

    #[error(
        "Device screen appears to be turned off or locked. Please unlock the screen to continue."
    )]
    ScreenLocked,

    #[error("Could not find any visible text or button matching '{0}' on the current screen.")]
    TextNotFound(String),

    #[error("Unknown target '{target}'. Available targets in .palprc.json:\n{available}")]
    UnknownTarget { target: String, available: String },

    #[error("{0}")]
    InvalidInput(String),

    #[error("'{text}' did not appear on screen within {secs} s.")]
    DidNotAppear { text: String, secs: u64 },

    #[error("'{text}' was still on screen after {secs} s.")]
    StillOnScreen { text: String, secs: u64 },

    #[error("ADB command failed: {0}")]
    AdbFailed(String),

    #[error(
        "Operation timed out after {0} seconds. The phone or ADB may be busy or disconnected."
    )]
    Timeout(u64),

    #[error("Failed to read or write image: {0}")]
    Image(#[from] image::ImageError),

    #[error("File or system error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Configuration format error: {0}")]
    Json(#[from] serde_json::Error),
}