synaps 0.1.0

Terminal-native AI agent runtime — parallel orchestration, reactive subagents, MCP, autonomous supervision
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

//! Integration tests for the `sidecar.spawn_args` plugin self-config RPC.
//!
//! Phase 7 deassume-the-host slice F: core no longer reads
//! plugin-namespaced config. Instead it asks the plugin via
//! `sidecar.spawn_args`. This file proves the round trip end-to-end:
//! a fixture extension responds to the RPC, and the manager wrapper
//! decodes the typed `SidecarSpawnArgs`.

use std::sync::Arc;

use synaps_cli::extensions::hooks::HookBus;
use synaps_cli::extensions::manager::ExtensionManager;
use synaps_cli::extensions::manifest::{
    ExtensionManifest, ExtensionRuntime, CURRENT_EXTENSION_PROTOCOL_VERSION,
};

fn fixture_path() -> String {
    std::env::current_dir()
        .unwrap()
        .join("tests/fixtures/spawn_args_extension.py")
        .to_string_lossy()
        .to_string()
}

fn manifest() -> ExtensionManifest {
    ExtensionManifest {
        protocol_version: CURRENT_EXTENSION_PROTOCOL_VERSION,
        runtime: ExtensionRuntime::Process,
        command: "python3".to_string(),
        setup: None,
        prebuilt: ::std::collections::HashMap::new(),
        args: vec![fixture_path()],
        // Need at least one registration permission so the extension
        // is permitted to load with no hooks. `audio.input` matches
        // what the existing `extensions_info` fixture uses.
        permissions: vec!["audio.input".to_string()],
        hooks: vec![],
        config: vec![],
    }
}

#[tokio::test(flavor = "current_thread")]
async fn manager_returns_plugin_supplied_spawn_args() {
    std::env::set_var("SPAWN_ARGS_MODE", "ok");
    let mut manager = ExtensionManager::new(Arc::new(HookBus::new()));

    manager.load("spawn-args-ext", &manifest()).await.unwrap();

    let spawn_args = manager
        .sidecar_spawn_args("spawn-args-ext")
        .await
        .expect("plugin should reply with spawn args");

    assert_eq!(
        spawn_args.args,
        vec![
            "--model-path",
            "/plugin/owned/model.bin",
            "--language",
            "en"
        ]
    );
    assert_eq!(spawn_args.language.as_deref(), Some("en"));

    std::env::remove_var("SPAWN_ARGS_MODE");
    manager.shutdown_all().await;
}

#[tokio::test(flavor = "current_thread")]
async fn manager_propagates_method_not_found_error() {
    std::env::set_var("SPAWN_ARGS_MODE", "missing");
    let mut manager = ExtensionManager::new(Arc::new(HookBus::new()));

    manager.load("legacy-ext", &manifest()).await.unwrap();

    let err = manager.sidecar_spawn_args("legacy-ext").await.unwrap_err();
    assert!(
        err.contains("method not found") || err.contains("unknown method"),
        "expected method-not-found error, got: {err}"
    );

    std::env::remove_var("SPAWN_ARGS_MODE");
    manager.shutdown_all().await;
}

#[tokio::test(flavor = "current_thread")]
async fn manager_rejects_invalid_response_payload() {
    std::env::set_var("SPAWN_ARGS_MODE", "invalid");
    let mut manager = ExtensionManager::new(Arc::new(HookBus::new()));

    manager.load("invalid-ext", &manifest()).await.unwrap();

    let err = manager
        .sidecar_spawn_args("invalid-ext")
        .await
        .unwrap_err();
    assert!(
        err.contains("Invalid sidecar.spawn_args response"),
        "expected decode-error message, got: {err}"
    );

    std::env::remove_var("SPAWN_ARGS_MODE");
    manager.shutdown_all().await;
}

#[tokio::test(flavor = "current_thread")]
async fn manager_accepts_empty_object_as_defaults() {
    std::env::set_var("SPAWN_ARGS_MODE", "minimal");
    let mut manager = ExtensionManager::new(Arc::new(HookBus::new()));

    manager.load("min-ext", &manifest()).await.unwrap();

    let spawn_args = manager.sidecar_spawn_args("min-ext").await.unwrap();
    assert!(spawn_args.args.is_empty());
    assert_eq!(spawn_args.language, None);

    std::env::remove_var("SPAWN_ARGS_MODE");
    manager.shutdown_all().await;
}

#[tokio::test(flavor = "current_thread")]
async fn manager_returns_unknown_extension_for_missing_id() {
    let manager = ExtensionManager::new(Arc::new(HookBus::new()));
    let err = manager
        .sidecar_spawn_args("does-not-exist")
        .await
        .unwrap_err();
    assert!(err.contains("unknown extension"), "got: {err}");
}