a3s 0.10.5

a3s — A3S coding agent CLI; `a3s code` launches the interactive TUI
Documentation 
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

use std::time::{SystemTime, UNIX_EPOCH};

use a3s_boot::{BootError, Result as BootResult};

const MAX_ID_LENGTH: usize = 128;
const MAX_NAME_LENGTH: usize = 255;

pub(super) fn validate_id(id: &str, label: &str) -> BootResult<()> {
    if id.is_empty()
        || id.len() > MAX_ID_LENGTH
        || !id
            .bytes()
            .all(|byte| byte.is_ascii_alphanumeric() || matches!(byte, b'-' | b'_'))
    {
        return Err(BootError::BadRequest(format!(
            "{label} id must contain only ASCII letters, numbers, hyphens, or underscores"
        )));
    }
    Ok(())
}

pub(super) fn validate_name(value: &str, label: &str) -> BootResult<()> {
    let value = value.trim();
    if value.is_empty() {
        return Err(BootError::BadRequest(format!("{label} cannot be empty")));
    }
    if value.chars().count() > MAX_NAME_LENGTH {
        return Err(BootError::BadRequest(format!(
            "{label} cannot exceed {MAX_NAME_LENGTH} characters"
        )));
    }
    if value.chars().any(char::is_control) {
        return Err(BootError::BadRequest(format!(
            "{label} cannot contain control characters"
        )));
    }
    Ok(())
}

pub(super) fn validate_file_name(value: String) -> BootResult<String> {
    let value = value.trim().to_string();
    validate_name(&value, "source file name")?;
    if value.contains('/') || value.contains('\\') {
        return Err(BootError::BadRequest(
            "source file name cannot contain path separators".to_string(),
        ));
    }
    Ok(value)
}

pub(super) fn validate_content_type(value: Option<String>) -> BootResult<String> {
    let value = value
        .as_deref()
        .map(str::trim)
        .filter(|value| !value.is_empty())
        .unwrap_or("application/octet-stream");
    if value.len() > 255 || value.chars().any(char::is_control) {
        return Err(BootError::BadRequest(
            "source content type is invalid".to_string(),
        ));
    }
    Ok(value.to_string())
}

pub(super) fn ensure_revision(
    resource: &str,
    id: &str,
    expected_revision: u64,
    actual_revision: u64,
) -> BootResult<()> {
    if expected_revision == actual_revision {
        Ok(())
    } else {
        Err(revision_conflict(resource, id, actual_revision))
    }
}

pub(super) fn revision_conflict(resource: &str, id: &str, actual_revision: u64) -> BootError {
    BootError::Conflict(format!(
        "Work {resource} `{id}` changed on the server; current revision is {actual_revision}"
    ))
}

pub(super) fn now_millis() -> u64 {
    SystemTime::now()
        .duration_since(UNIX_EPOCH)
        .unwrap_or_default()
        .as_millis() as u64
}