agent-tools-interface 0.7.9

Agent Tools Interface — secure CLI for AI agent tool execution
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

"""Tests for ati.scope — scope parsing and wildcard matching."""

from ati import build_scope_string, check_scope, matches_wildcard, parse_scopes


class TestParseScopes:
    def test_basic(self):
        assert parse_scopes("tool:a tool:b") == ["tool:a", "tool:b"]

    def test_empty(self):
        assert parse_scopes("") == []

    def test_single(self):
        assert parse_scopes("tool:web_search") == ["tool:web_search"]

    def test_mixed(self):
        assert parse_scopes("tool:a skill:b help") == ["tool:a", "skill:b", "help"]


class TestMatchesWildcard:
    def test_exact_match(self):
        assert matches_wildcard("tool:web_search", "tool:web_search")

    def test_no_match(self):
        assert not matches_wildcard("tool:web_search", "tool:github:search")

    def test_global_wildcard(self):
        assert matches_wildcard("tool:anything", "*")

    def test_prefix_wildcard(self):
        assert matches_wildcard("tool:github:search_repos", "tool:github:*")
        assert matches_wildcard("tool:github:create_issue", "tool:github:*")

    def test_prefix_wildcard_no_match(self):
        assert not matches_wildcard("tool:linear:list", "tool:github:*")

    def test_wildcard_not_at_end(self):
        # Only trailing * is supported
        assert not matches_wildcard("tool:abc", "tool:*bc")

    def test_empty_pattern(self):
        assert not matches_wildcard("tool:x", "")

    def test_empty_name(self):
        assert not matches_wildcard("", "tool:x")
        assert matches_wildcard("", "*")


class TestBuildScopeString:
    def test_tools_only(self):
        result = build_scope_string(tools=["web_search", "github:*"])
        assert result == "tool:web_search tool:github:*"

    def test_skills_only(self):
        result = build_scope_string(skills=["research-*"])
        assert result == "skill:research-*"

    def test_mixed(self):
        result = build_scope_string(
            tools=["web_search"], skills=["analysis"], extra=["help"]
        )
        assert result == "tool:web_search skill:analysis help"

    def test_empty(self):
        assert build_scope_string() == ""

    def test_no_double_prefix(self):
        # If already prefixed, don't double-prefix
        result = build_scope_string(tools=["tool:web_search"])
        assert result == "tool:web_search"

    def test_skill_no_double_prefix(self):
        result = build_scope_string(skills=["skill:my-skill"])
        assert result == "skill:my-skill"


class TestCheckScope:
    def test_exact_grant(self):
        assert check_scope("tool:web_search", ["tool:web_search", "tool:other"])

    def test_wildcard_grant(self):
        assert check_scope("tool:github:search", ["tool:github:*"])

    def test_global_grant(self):
        assert check_scope("tool:anything", ["*"])

    def test_no_grant(self):
        assert not check_scope("tool:secret", ["tool:web_search"])

    def test_empty_granted(self):
        assert not check_scope("tool:x", [])