fastshell 0.3.7

Lightweight Bash + Python runtime SDK for mobile AI agents
Documentation
// Copyright (c) 2025 xiefujin <490021684@qq.com>
// Licensed under Apache-2.0, see LICENSE file for full license terms.

pub const EXIT_NEED_PERMISSION: i32 = 100;

#[derive(Debug, Clone)]
pub struct CommandResult {
    pub stdout: String,
    pub stderr: String,
    pub exit_code: i32,
}

impl CommandResult {
    pub fn success(stdout: String) -> Self {
        CommandResult {
            stdout,
            stderr: String::new(),
            exit_code: 0,
        }
    }

    pub fn error(message: String) -> Self {
        CommandResult {
            stdout: String::new(),
            stderr: message,
            exit_code: 1,
        }
    }

    pub fn from_code(stdout: String, stderr: String, exit_code: i32) -> Self {
        CommandResult {
            stdout,
            stderr,
            exit_code,
        }
    }

    pub fn is_success(&self) -> bool {
        self.exit_code == 0
    }

    pub fn needs_permission(&self) -> bool {
        self.exit_code == EXIT_NEED_PERMISSION
    }

    pub fn permission_needed(resource_type: &str, resource: &str) -> Self {
        CommandResult {
            stdout: String::new(),
            stderr: format!("PERMISSION_NEEDED:{}:{}", resource_type, resource),
            exit_code: EXIT_NEED_PERMISSION,
        }
    }
}

#[derive(Debug, Clone)]
pub struct Config {
    pub sandbox_path: String,
    pub python_enabled: bool,
    pub python_home: String,
    pub command_timeout_ms: u64,
    pub allow_subprocess: bool,
    pub network_ask_permission: bool,
}

impl Default for Config {
    fn default() -> Self {
        Config {
            sandbox_path: String::new(),
            python_enabled: true,
            python_home: String::new(),
            command_timeout_ms: 30_000,
            allow_subprocess: true,
            network_ask_permission: cfg!(any(target_os = "android", target_os = "ios")),
        }
    }
}

#[derive(Debug, Clone)]
pub struct SdkInfo {
    pub version: String,
    pub platform: String,
    pub python_available: bool,
    pub sandbox_path: String,
    pub allow_subprocess: bool,
}

#[derive(Debug, Clone)]
pub struct FileEntry {
    pub name: String,
    pub path: String,
    pub is_dir: bool,
    pub size: u64,
}