faculties 0.21.0

An office suite for AI agents: kanban, wiki, files, messaging, and a Lissajous-backed viewer — all persisted in a TribleSpace pile.
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

//! Status MCP tools: literal prose and an explicit window/persona.

use super::{render, Status as Operations};
use crate::mcp::{decode_arguments, Faculty, Tool};
use crate::out::Out;
use anybytes::Bytes;
use anyhow::{bail, Result};
use serde::Deserialize;
use std::path::PathBuf;

const TOOLS: &[Tool] = &[
    Tool {
        name: "status_set",
        description: "Set the status of an explicitly named window. Persona is a Relations label/alias or exact 32-character window id, including unknown ids. Text is literal; no host files or ambient PERSONA are read.",
        input_schema: r#"{"type":"object","properties":{"persona":{"type":"string"},"text":{"type":"string"}},"required":["persona","text"],"additionalProperties":false}"#,
    },
    Tool {
        name: "status_list",
        description: "Show the latest status of every window.",
        input_schema: r#"{"type":"object","properties":{},"additionalProperties":false}"#,
    },
    Tool {
        name: "status_show",
        description: "Show a window's current status and recent history. Retired personas remain selectable; ambiguous or forked labels fail visibly.",
        input_schema: r#"{"type":"object","properties":{"window":{"type":"string"},"limit":{"type":"integer","minimum":0,"default":10}},"required":["window"],"additionalProperties":false}"#,
    },
];

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
struct SetArguments {
    persona: String,
    text: String,
}

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
struct ListArguments {}

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
struct ShowArguments {
    window: String,
    #[serde(default = "default_limit")]
    limit: usize,
}
fn default_limit() -> usize {
    10
}

pub struct Status {
    operations: Operations,
}
impl Status {
    pub fn new(pile: PathBuf, key: Option<PathBuf>) -> Self {
        Self::with_storage(crate::storage::Storage::new(pile, key))
    }
    pub fn with_storage(storage: crate::storage::Storage) -> Self {
        Self {
            operations: Operations::with_storage(storage),
        }
    }
}
impl Faculty for Status {
    fn tools(&self) -> &[Tool] {
        TOOLS
    }
    fn call(&self, name: &str, arguments: Bytes, output: &mut Out<'_>) -> Result<()> {
        match name {
            "status_set" => {
                let args: SetArguments = decode_arguments(arguments)?;
                render::set(&self.operations.set(&args.persona, &args.text)?, output)
            }
            "status_list" => {
                let _: ListArguments = decode_arguments(arguments)?;
                render::list(&self.operations.list()?, output)
            }
            "status_show" => {
                let args: ShowArguments = decode_arguments(arguments)?;
                render::show(&self.operations.show(&args.window, args.limit)?, output)
            }
            other => bail!("Status MCP has no tool {other:?}"),
        }
    }
}