Validators

Production-ready validators for Python and TypeScript. Validate JSON Agents manifests, policy expressions, and ajson:// URIs.

VIEW ON GITHUB

Installation

Python

# Install via pip (coming soon)
Coming soon.

TypeScript/JavaScript

# Install via npm (coming soon)
Coming soon.

📦 Package publishing coming soon. For now, install from source in validators/python or validators/typescript

Quick Start

Python Validator

from jsonagents import validate

agent_data = {
  "name": "MyAgent",
  "version": "1.0.0",
  "capabilities": ["action", "query"]
}

result = validate(agent_data)
print(result.valid)

TypeScript Validator

import { validate } from '@jsonagents/validator';

const agentData = {
  name: "MyAgent",
  version: "1.0.0",
  capabilities: ["action", "query"]
};

const result = validate(agentData);
console.log(result.valid);

Key Features

Schema Validation

Comprehensive validation against JSON Agents specification

Policy Enforcement

Validate agent policies and security constraints

URI Validation

Validate JSON Agents URI scheme compliance

Detailed Error Reports

Clear error messages with field-level validation details

Available Validators

Python Validator

Full-featured Python implementation with CLI support and comprehensive testing

  • Schema validation with jsonschema library
  • Policy language validation and evaluation
  • URI scheme validation and parsing
  • Command-line interface for batch validation

TypeScript Validator

Type-safe TypeScript implementation for Node.js and browser environments

  • Type definitions for full IDE support
  • AJV-based schema validation
  • Policy expression evaluation
  • Works in Node.js and modern browsers

Running Tests

Python

cd validators/python
pytest

TypeScript

cd validators/typescript
npm test

Resources

View validator source code on GitHub→ Check out the CLI Tool→ Getting Started Guide→ View JSON Schema