Skip to content

Manifest

doublegate_sdk.manifest

SDK 0.1 declarative manifest. JSON is the supported YAML subset.

No imports, entrypoints, installation, grants or deployment occur during validation. Manifests and response checks share a bounded stdlib schema engine. Manifest integer strictness and bounded diagnostics remain SDK policy.

ManifestError

Bases: DoublegateError, ValueError

Bounded diagnostic: never echo manifest values or unknown property names.

Source code in src/doublegate_sdk/manifest.py 
42
43
44
45
46
47
48
49
50
51
class ManifestError(DoublegateError, ValueError):
    """Bounded diagnostic: never echo manifest values or unknown property names."""
    code = 'invalid_manifest'
    kind = 'invalid_manifest'
    retryable = False

    def __init__(self, path: str, reason: str):
        self.path = path
        self.reason = reason
        super().__init__(f'{self.code} at {path or "/"}: {reason}')

code class-attribute instance-attribute 

code = 'invalid_manifest'

kind class-attribute instance-attribute 

kind = 'invalid_manifest'

retryable class-attribute instance-attribute 

retryable = False

path instance-attribute 

path = path

reason instance-attribute 

reason = reason

GatePackage dataclass

Source code in src/doublegate_sdk/manifest.py 
54
55
56
57
58
59
60
61
@dataclass(frozen=True, slots=True)
class GatePackage:
    name: str
    version: str
    artifact_types: tuple[str, ...]
    required_text: tuple[str, ...]
    max_input_bytes: int
    human_review: str

name instance-attribute 

name: str

version instance-attribute 

version: str

artifact_types instance-attribute 

artifact_types: tuple[str, ...]

required_text instance-attribute 

required_text: tuple[str, ...]

max_input_bytes instance-attribute 

max_input_bytes: int

human_review instance-attribute 

human_review: str

manifest_schema 

manifest_schema() -> dict[str, Any]

Return a fresh, externally usable Draft 2020-12 schema.

Source code in src/doublegate_sdk/manifest.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
def manifest_schema() -> dict[str, Any]:
    """Return a fresh, externally usable Draft 2020-12 schema."""
    properties = {
        'schema_version': {'type': 'string', 'const': '0.1'},
        'sdk_version': {'type': 'string', 'const': '0.1'},
        'name': {'type': 'string', 'maxLength': 64, 'pattern': '^[a-z][a-z0-9-]*$'},
        'version': {'type': 'string', 'maxLength': 32, 'pattern': '^[0-9]+\\.[0-9]+\\.[0-9]+$'},
        'artifact_types': {'type': 'array', 'minItems': 1, 'maxItems': 4, 'uniqueItems': True,
                           'items': {'type': 'string', 'enum': ['memory', 'skill', 'script', 'tool']}},
        'checks': {'type': 'array', 'minItems': 1, 'maxItems': 32, 'items': {
            'type': 'object', 'additionalProperties': False, 'required': ['capability', 'text'],
            'properties': {'capability': {'type': 'string', 'const': 'required-text'},
                           'text': {'type': 'string', 'minLength': 1, 'maxLength': 256}}}},
        'max_input_bytes': {'type': 'integer', 'minimum': 1, 'maximum': 1048576},
        'human_review': {'type': 'string', 'enum': ['inherit', 'required']},
        'egress': {'type': 'array', 'maxItems': 0},
        'secret_refs': {'type': 'array', 'maxItems': 0},
    }
    return {'$schema': 'https://json-schema.org/draft/2020-12/schema',
            'title': 'Doublegate declarative gate manifest 0.1', 'type': 'object',
            'additionalProperties': False, 'required': list(properties), 'properties': properties}

validate_manifest 

validate_manifest(value: Any) -> GatePackage

Validate data before constructing an immutable declarative package.

Source code in src/doublegate_sdk/manifest.py 
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
def validate_manifest(value: Any) -> GatePackage:
    """Validate data before constructing an immutable declarative package."""
    error = next(iter_errors(manifest_schema(), value, strict_integer=True,
                             string_limit=256, python_unique=True), None)
    if error is not None:
        reasons = {'type': 'wrong_type', 'const': 'unsupported_value',
                   'enum': 'unsupported_value', 'additionalProperties': 'unknown_field',
                   'required': 'required_field', 'minItems': 'array_bounds',
                   'maxItems': 'array_bounds', 'uniqueItems': 'duplicate_item',
                   'minLength': 'string_bounds', 'maxLength': 'string_bounds',
                   'pattern': 'invalid_format', 'minimum': 'integer_bounds',
                   'maximum': 'integer_bounds'}
        path = _pointer(error.path, error.missing) if error.missing is not None else error.path
        raise ManifestError(path, reasons[error.keyword])
    return GatePackage(value['name'], value['version'], tuple(value['artifact_types']),
                       tuple(check['text'] for check in value['checks']),
                       value['max_input_bytes'], value['human_review'])