oino-resources 1.0.0

Resource loading for Oino: context files, skills, prompt templates, system prompt, project trust
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
90
91
92

//! Resource provenance (`source-info`, `PathMetadata`).

use std::path::{Path, PathBuf};

use serde::{Deserialize, Serialize};

/// Where a resource was configured.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum SourceScope {
    /// Agent dir / user settings.
    User,
    /// Project `.oino` / project settings / project `.agents`.
    Project,
    /// CLI flags or other session-only sources.
    #[default]
    Temporary,
}

/// Whether a resource came from a package or a top-level path.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "kebab-case")]
pub enum SourceOrigin {
    /// Provided by an installed package.
    Package,
    /// A path from settings, auto-discovery or the CLI.
    #[default]
    TopLevel,
}

/// Resolution metadata of a discovered path.
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct PathMetadata {
    /// `auto`, `local`, `cli`, a package source, … (a free string).
    pub source: String,
    /// Scope.
    pub scope: SourceScope,
    /// Origin.
    pub origin: SourceOrigin,
    /// Directory relative entries resolve against.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub base_dir: Option<PathBuf>,
}

/// Provenance attached to a loaded resource.
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct SourceInfo {
    /// Resource path.
    pub path: PathBuf,
    /// Source kind (see [`PathMetadata::source`]).
    pub source: String,
    /// Scope.
    pub scope: SourceScope,
    /// Origin.
    pub origin: SourceOrigin,
    /// Base dir.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub base_dir: Option<PathBuf>,
}

impl SourceInfo {
    /// C r e a t e   S o u r c e   I n f o.
    #[must_use]
    pub fn from_metadata(path: &Path, metadata: &PathMetadata) -> Self {
        Self {
            path: path.to_path_buf(),
            source: metadata.source.clone(),
            scope: metadata.scope,
            origin: metadata.origin,
            base_dir: metadata.base_dir.clone(),
        }
    }

    /// Creates synthetic source info (scope defaults to temporary, origin to top-level).
    #[must_use]
    pub fn synthetic(
        path: &Path,
        source: &str,
        scope: Option<SourceScope>,
        base_dir: Option<PathBuf>,
    ) -> Self {
        Self {
            path: path.to_path_buf(),
            source: source.to_owned(),
            scope: scope.unwrap_or_default(),
            origin: SourceOrigin::TopLevel,
            base_dir,
        }
    }
}