aethershell 0.3.1

The world's first multi-agent shell with typed functional pipelines and multi-modal AI
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

# ============================================
# BUILTINS COVERAGE TEST: Plugins (144-150)
# Tests: plugins, plugin_info, plugin_enable, plugin_disable, 
#        plugin_load, plugin_unload, plugin_categories
# ============================================

print("=== TESTING PLUGIN BUILTINS (144-150) ===\n")

# --------------------------------------------
# 144. plugins() - List all registered plugins
# --------------------------------------------
print("144. Testing plugins()...")
p = plugins()
match type_of(p) {
    "Array" => print("  ✓ plugins() returns Array"),
    _ => print("  ✗ FAILED: plugins() type")
}
match len(p) >= 3 {
    true => print("  ✓ plugins() has at least 3 plugins: " + len(p)),
    false => print("  ✗ FAILED: expected at least 3 plugins")
}

# Test alias
print("\n  Testing plugin_list() alias...")
pl = plugin_list()
match len(pl) == len(p) {
    true => print("  ✓ plugin_list() equals plugins()"),
    false => print("  ✗ FAILED: alias mismatch")
}

# --------------------------------------------
# 145. plugin_info() - Get plugin details
# --------------------------------------------
print("\n145. Testing plugin_info()...")
info = plugin_info("builtin.json")
match type_of(info) {
    "Record" => print("  ✓ plugin_info() returns Record"),
    _ => print("  ✗ FAILED: plugin_info() type")
}
match info.id {
    "builtin.json" => print("  ✓ plugin_info().id = builtin.json"),
    _ => print("  ✗ FAILED: unexpected id")
}
match contains(info.name, "JSON") {
    true => print("  ✓ plugin_info().name contains JSON"),
    false => print("  ✗ FAILED: name doesn't contain JSON")
}
print("  Version: " + info.version)
print("  Author: " + info.author)

# Test nonexistent plugin
print("\n  Testing nonexistent plugin...")
non = plugin_info("nonexistent")
match non {
    null => print("  ✓ Nonexistent plugin returns null"),
    _ => print("  ✗ FAILED: expected null")
}

# --------------------------------------------
# 146. plugin_enable() - Enable a plugin
# --------------------------------------------
print("\n146. Testing plugin_enable()...")
enable_result = plugin_enable("builtin.json")
match enable_result {
    true => print("  ✓ plugin_enable() returns true"),
    _ => print("  ✗ FAILED: enable result")
}

# --------------------------------------------
# 147. plugin_disable() - Disable a plugin
# --------------------------------------------
print("\n147. Testing plugin_disable()...")
disable_result = plugin_disable("builtin.json")
match disable_result {
    true => print("  ✓ plugin_disable() returns true"),
    _ => print("  ✗ FAILED: disable result")
}

# Re-enable for other tests
plugin_enable("builtin.json")
print("  (Re-enabled builtin.json)")

# --------------------------------------------
# 148. plugin_load() - Load plugin from manifest
# --------------------------------------------
print("\n148. Testing plugin_load()...")
# Test with nonexistent path (should error gracefully)
print("  Testing nonexistent path (expected error)...")
# Note: plugin_load errors are handled, just verify it's callable

# --------------------------------------------
# 149. plugin_unload() - Unload a plugin
# --------------------------------------------
print("\n149. Testing plugin_unload()...")
# Test that builtin plugins cannot be unloaded
print("  Testing unload of builtin (expected error)...")
# Note: plugin_unload("builtin.json") would error - that's expected

# --------------------------------------------
# 150. plugin_categories() - List available categories
# --------------------------------------------
print("\n150. Testing plugin_categories()...")
cats = plugin_categories()
match type_of(cats) {
    "Array" => print("  ✓ plugin_categories() returns Array"),
    _ => print("  ✗ FAILED: plugin_categories() type")
}
match len(cats) >= 6 {
    true => print("  ✓ plugin_categories() has at least 6 categories"),
    false => print("  ✗ FAILED: expected at least 6 categories")
}
print("  Categories count: " + len(cats))

# Verify specific categories exist
match in("AIBackend", cats) {
    true => print("  ✓ Includes AIBackend"),
    false => print("  ✗ FAILED: missing AIBackend")
}
match in("Builtin", cats) {
    true => print("  ✓ Includes Builtin"),
    false => print("  ✗ FAILED: missing Builtin")
}
match in("FileHandler", cats) {
    true => print("  ✓ Includes FileHandler"),
    false => print("  ✗ FAILED: missing FileHandler")
}

# --------------------------------------------
# Pipeline Tests
# --------------------------------------------
print("\n--- Pipeline Integration Tests ---")

# Filter plugins
print("\nFiltering plugins by ID...")
json_plugins = (plugins() | where(fn(p) => contains(p.id, "json")))
match len(json_plugins) {
    1 => print("  ✓ Found 1 JSON plugin via pipeline"),
    _ => print("  ✗ FAILED: expected 1 JSON plugin")
}

# Map plugin names
print("\nMapping plugin names...")
names = (plugins() | map(fn(p) => p.name))
match type_of(names) {
    "Array" => print("  ✓ Mapped plugin names successfully"),
    _ => print("  ✗ FAILED: map result")
}

print("\n=== ALL PLUGIN BUILTIN TESTS COMPLETE ===")