tambo 0.11.1

Install and prove the whole AI knowledge-tool kit
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

#!/usr/bin/env python3
"""Offline producer controls; native rendering is a separate paired control."""
import base64
import importlib.util
import os
from pathlib import Path
import tempfile
import unittest
from unittest.mock import patch

spec = importlib.util.spec_from_file_location('producer', Path(__file__).resolve().parents[1] / 'scripts/skill-render-source.py')
producer = importlib.util.module_from_spec(spec)
spec.loader.exec_module(producer)


class SourceTests(unittest.TestCase):
    def fixture(self, root):
        (root / 'SKILL.md').write_text('---\nname: example\n---\n{{ untouched }}\nUnicode λ\n')
        (root / 'SKILL.md').chmod(0o644)

    def test_raw_and_binary_deterministic(self):
        with tempfile.TemporaryDirectory() as folder:
            root = Path(folder)
            self.fixture(root)
            (root / 'tool').write_bytes(b'\x00\xff\x01')
            (root / 'tool').chmod(0o755)
            result = producer.compile_skill(root)
            self.assertEqual(result, producer.compile_skill(root))
            self.assertEqual(base64.b64decode(result['includes'][0]['base64']), b'\x00\xff\x01')
            self.assertEqual(result['includes'][0]['mode'], 0o755)
            self.assertEqual(result['template'], '{{ rows[0].content }}')
            self.assertFalse(result['provenance'])

    def test_refuses_symlink_even_if_target_is_inside(self):
        with tempfile.TemporaryDirectory() as folder:
            root = Path(folder)
            self.fixture(root)
            (root / 'alias').symlink_to('SKILL.md')
            with self.assertRaises(ValueError):
                producer.compile_skill(root)

    def test_missing_entry_and_unsafe_path(self):
        with tempfile.TemporaryDirectory() as folder:
            root = Path(folder)
            with self.assertRaises(ValueError):
                producer.compile_skill(root)
            self.fixture(root)
            (root / '{name}').write_text('unsafe')
            with self.assertRaises(ValueError):
                producer.compile_skill(root)

    def test_mode_and_size_refuse(self):
        with tempfile.TemporaryDirectory() as folder:
            root = Path(folder)
            self.fixture(root)
            (root / 'SKILL.md').chmod(0o600)
            with self.assertRaises(ValueError):
                producer.compile_skill(root)
            (root / 'SKILL.md').chmod(0o644)
            (root / 'huge').write_bytes(b'x' * (producer.MAX_BYTES + 1))
            with self.assertRaises(ValueError):
                producer.compile_skill(root)


    def test_special_file_root_symlink_and_invalid_utf8(self):
        with tempfile.TemporaryDirectory() as folder:
            root = Path(folder)
            source = root / 'source'
            source.mkdir()
            self.fixture(source)
            (root / 'alias').symlink_to(source, target_is_directory=True)
            with self.assertRaises(OSError):
                producer.compile_skill(root / 'alias')
            os.mkfifo(source / 'pipe')
            with self.assertRaises(ValueError):
                producer.compile_skill(source)
            (source / 'pipe').unlink()
            (source / 'SKILL.md').write_bytes(b'\xff')
            with self.assertRaises(UnicodeError):
                producer.compile_skill(source)



    def test_replacement_between_stat_and_open_refuses(self):
        with tempfile.TemporaryDirectory() as folder:
            root = Path(folder)
            self.fixture(root)
            native_open = os.open

            def change_before_open(path, flags, **kwargs):
                if path == 'SKILL.md':
                    (root / 'SKILL.md').write_text('changed after metadata check')
                return native_open(path, flags, **kwargs)

            with patch.object(producer.os, 'open', side_effect=change_before_open):
                with self.assertRaisesRegex(ValueError, 'changed before read'):
                    producer.compile_skill(root)



    def test_empty_directories_count_toward_streamed_entry_budget(self):
        with tempfile.TemporaryDirectory() as folder:
            root = Path(folder)
            self.fixture(root)
            for name in ['one', 'two']:
                (root / name).mkdir()
            with patch.object(producer, 'MAX_ENTRIES', 3):
                self.assertEqual(producer.compile_skill(root)['path'], 'SKILL.md')
            with patch.object(producer, 'MAX_ENTRIES', 2):
                with self.assertRaisesRegex(ValueError, 'entry budget'):
                    producer.compile_skill(root)



if __name__ == '__main__':
    unittest.main()