yog 0.0.51

yog: the standalone server for litany loops — the world, the balls and the conversations, behind one wire
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

//! REMOTE §5's pair on the line (bl-4e08): a presentation whose whole tail is a
//! JSON document, and the roster that reads it back.

use super::rt;
use crate::boundary::{Action, Gesture, Query};

/// One advertised tool, with a schema deep enough that a spelling which rebuilt
/// it rather than carrying it verbatim would show.
fn advertised() -> crate::registry::tools::Tool {
    crate::registry::tools::Tool {
        name: "Bash".to_owned(),
        description: "run a command".to_owned(),
        input_schema: serde_json::json!({
            "type": "object",
            "properties": {"command": {"type": "string", "minLength": 1}},
            "required": ["command"],
        }),
        subject_cwd: false,
    }
}

/// The set is the whole tail, so the round trip is what says a **document**
/// survives a line — and the empty set has to be typable, or a tool host could
/// never withdraw one.
#[test]
fn the_presentation_round_trips_with_its_schema_and_when_it_is_empty() {
    let consenting = crate::registry::tools::Tool {
        subject_cwd: true,
        ..advertised()
    };
    for tools in [Vec::new(), vec![advertised()], vec![consenting]] {
        rt(Gesture::Act(Action::Advertise { tools }));
    }
}

/// The routing leg's four (bl-024b). Both acts end in a document taken
/// verbatim, so the round trip is what says a JSON payload survives a line;
/// both reads state only what no seat can supply, which for one of them is
/// nothing at all.
#[test]
fn the_routing_legs_gestures_round_trip() {
    for cwd in [None, Some("/w/home/agents/c-1".to_owned())] {
        rt(Gesture::Act(Action::Route(
            crate::registry::mailbox::Verb::Invoke(crate::registry::mailbox::Call {
                client: "laptop".to_owned(),
                tool: "Bash".to_owned(),
                input: serde_json::json!({"command": "ls -l", "timeout": 30}),
                cwd,
            }),
        )));
    }
    rt(Gesture::Act(Action::Route(
        crate::registry::mailbox::Verb::Complete(crate::registry::mailbox::Completion {
            invocation: "inv-1".to_owned(),
            capture: crate::registry::mailbox::Capture {
                stdout: "hello\n".to_owned(),
                stderr: "warned\n".to_owned(),
                exit_code: 3,
            },
        }),
    )));
    rt(Gesture::Ask(Query::Invocations));
    rt(Gesture::Ask(Query::Capture {
        invocation: "inv-1".to_owned(),
    }));
}

/// The lane's flag must name a directory: a bare `--cwd` is the line's own
/// refusal, before any gesture exists (bl-77be).
#[test]
fn a_cwd_flag_naming_nothing_is_refused() {
    let e = crate::boundary::line::parse(
        "/invoke laptop Bash --cwd",
        &crate::boundary::line::Context::default(),
    )
    .expect_err("refused");
    assert!(e.contains("--cwd names no directory"), "{e}");
}

/// The roster spells as the verb alone: its workspace is the seat's, exactly as
/// `/providers`' is.
#[test]
fn the_roster_spells_as_the_verb_alone() {
    rt(Gesture::Ask(Query::Clients {
        workspace: "ws".to_owned(),
    }));
}

/// **The doctor spells as the verb alone too, and takes the seat's workspace
/// when it has one** (bl-28f4). A seat with none selected still asks — which no
/// other workspace-addressed read allows, and is the whole point: the box this
/// gesture is for may hold no workspace at all.
#[test]
fn the_doctor_spells_as_the_verb_alone_with_or_without_a_workspace() {
    rt(Gesture::Ask(Query::Doctor {
        workspace: Some("ws".to_owned()),
    }));
    // Unselected is its own gesture and spells the same line; parsed back with a
    // seat that HAS a workspace it becomes that one, which is the context doing
    // its job rather than a round trip failing.
    let bare = Gesture::Ask(Query::Doctor { workspace: None });
    assert_eq!(crate::boundary::line::spell(&bare), "/doctor");
    assert_eq!(
        crate::boundary::line::parse("/doctor", &crate::boundary::line::Context::default()),
        Ok(bare)
    );
}