tambo 0.14.0

Install and prove the whole AI knowledge-tool kit
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

//! Explicit local skill publication/materialization. Never edits harness settings.
//! Catalogue files are caller-supplied inputs, not authenticated server evidence.
mod native;
mod publish;
mod sync;

use anyhow::{Context, Result};
use clap::Subcommand;
use serde::de::DeserializeOwned;
use std::{
    fs,
    path::{Path, PathBuf},
};

#[derive(Subcommand)]
pub enum Command {
    /// Build a native pendant and release metadata from one explicit source tree
    Publish {
        #[arg(long)]
        source: PathBuf,
        #[arg(long)]
        metadata: PathBuf,
        #[arg(long)]
        render_shapes: PathBuf,
        #[arg(long, requires = "identifier_shapes")]
        identifier_policy: Option<PathBuf>,
        #[arg(long, requires = "identifier_policy")]
        identifier_shapes: Option<PathBuf>,
        /// A NEW output directory; existing releases are never replaced
        #[arg(long)]
        output: PathBuf,
        #[arg(long, default_value = "quipu")]
        quipu: PathBuf,
    },
    /// Render a complete pinned profile into ONE owned staging directory
    Sync {
        #[arg(long)]
        profile: PathBuf,
        #[arg(long)]
        catalogue: PathBuf,
        /// Explicit local map: native share ID -> archive path (never URLs)
        #[arg(long)]
        bundles: PathBuf,
        /// Caller-selected native shape authority, not authority from a skill
        #[arg(long)]
        authority: PathBuf,
        #[arg(long)]
        render_shapes: PathBuf,
        /// Owned profile tree, NOT a shared harness root or settings file
        #[arg(long)]
        dest: PathBuf,
        #[arg(long, default_value = "quipu")]
        quipu: PathBuf,
    },
}

pub fn run(command: Command) -> Result<()> {
    let result = match command {
        Command::Publish {
            source,
            metadata,
            render_shapes,
            identifier_policy,
            identifier_shapes,
            output,
            quipu,
        } => publish::publish(
            &source,
            &metadata,
            &render_shapes,
            identifier_policy
                .as_deref()
                .zip(identifier_shapes.as_deref()),
            &output,
            &quipu,
        )?,
        Command::Sync {
            profile,
            catalogue,
            bundles,
            authority,
            render_shapes,
            dest,
            quipu,
        } => sync::sync(
            &profile,
            &catalogue,
            &bundles,
            &authority,
            &render_shapes,
            &dest,
            &quipu,
        )?,
    };
    println!("{}", serde_json::to_string_pretty(&result)?);
    Ok(())
}

fn read<T: DeserializeOwned>(path: &Path) -> Result<T> {
    let bytes = native::regular_bytes(path, 4 * 1024 * 1024)?;
    serde_json::from_slice(&bytes)
        .with_context(|| format!("invalid skill input: {}", path.display()))
}

fn write_json(path: &Path, value: &impl serde::Serialize) -> Result<()> {
    fs::write(path, serde_json::to_vec_pretty(value)?)?;
    Ok(())
}

#[cfg(test)]
mod tests;