objectiveai-cli 2.1.1

ObjectiveAI command-line interface and embeddable library
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

use reqwest::StatusCode;
use std::path::PathBuf;

/// Failures the plugin install pipeline can encounter. Shape modelled
/// after `objectiveai-api`'s `github::Error`: split request / response
/// / status / parse so diagnostics name what failed, plus IO variants
/// for the local-disk side of the flow.
///
/// **Platform-not-supported is NOT an error.** When the current
/// platform isn't in `Manifest.binaries`, `Client::install_plugin`
/// returns `Ok(false)` rather than any variant here. This enum is only
/// for things that actually went wrong.
#[derive(thiserror::Error, Debug)]
pub enum InstallError {
    #[error("manifest request failed: {0}")]
    ManifestRequest(reqwest::Error),
    #[error("manifest fetch returned bad status {code} from {url}: {body}")]
    ManifestBadStatus {
        code: StatusCode,
        url: String,
        body: String,
    },
    #[error("manifest body could not be read: {0}")]
    ManifestResponse(reqwest::Error),
    #[error("manifest parse failed: {0}")]
    ManifestParse(serde_path_to_error::Error<serde_json::Error>),
    #[error("binary request failed: {0}")]
    BinaryRequest(reqwest::Error),
    #[error("binary fetch returned bad status {code} from {url}")]
    BinaryBadStatus { code: StatusCode, url: String },
    #[error("binary body could not be read: {0}")]
    BinaryResponse(reqwest::Error),
    #[error("failed to create plugin directory {0}: {1}")]
    PluginDirCreate(PathBuf, std::io::Error),
    #[error("failed to write plugin binary {0}: {1}")]
    BinaryWrite(PathBuf, std::io::Error),
    #[error("failed to set executable permission on {0}: {1}")]
    Chmod(PathBuf, std::io::Error),
    #[error("failed to serialize manifest for persistence: {0}")]
    ManifestSerialize(serde_json::Error),
    #[error("failed to persist manifest at {0}: {1}")]
    ManifestPersist(PathBuf, std::io::Error),
    #[error("viewer-zip request failed: {0}")]
    ViewerZipRequest(reqwest::Error),
    #[error("viewer-zip fetch returned bad status {code} from {url}")]
    ViewerZipBadStatus { code: StatusCode, url: String },
    #[error("viewer-zip body could not be read: {0}")]
    ViewerZipResponse(reqwest::Error),
    #[error("failed to extract viewer zip into {0}: {1}")]
    ViewerZipExtract(PathBuf, String),
    #[error("invalid header name {name:?}: {reason}")]
    InvalidHeaderName { name: String, reason: String },
    #[error("invalid header value for {name:?}: {reason}")]
    InvalidHeaderValue { name: String, reason: String },
    #[error(
        "plugin {repository} is already installed; pass `--upgrade` to replace it"
    )]
    AlreadyInstalled { repository: String },
    #[error(
        "repository name {repository:?} is reserved and cannot be used as a plugin name"
    )]
    ReservedRepositoryName { repository: String },
    #[error("manifest failed validation: {0}")]
    ManifestInvalid(&'static str),
    /// `owner`, `repository`, or `commit` does not match the
    /// `^[A-Za-z0-9_.-]{1,128}$` shape required for them to land in a
    /// usable LLM tool name (Anthropic enforces `^[a-zA-Z0-9_-]{1,128}$`;
    /// we additionally allow `.` so semver-shaped version strings can
    /// flow through, with `.` -> `-` substitution applied when the tool
    /// name is materialized).
    #[error("invalid {kind}: {value:?} must match ^[A-Za-z0-9_.-]{{1,128}}$")]
    InvalidIdentifier { kind: &'static str, value: String },
    /// The materialized tool name (`{owner}-{name}-{version}` with `.`
    /// substituted to `-`) is longer than the 100-character budget we
    /// reserve. Anthropic's hard cap is 128 chars; the 28-char gap
    /// leaves headroom for the proxy prefix the MCP server stamps on
    /// (`oai_`, `oaifs_`, etc.) plus any future prefix growth.
    #[error("tool name {tool_name:?} is {len} chars long; max 100")]
    ToolNameTooLong { tool_name: String, len: usize },
}