Module: A2A::Protocol::JsonSchema

Defined in:
lib/a2a/protocol/json_schema.rb,
lib/a2a/protocol/json_schema/definition.rb,
lib/a2a/protocol/json_schema/validation_error.rb

Overview

Schema-validated A2A protocol objects, powered by json_schemer.

Loads the bundled data/a2a.json schema, rewrites external $ref values to internal #/definitions/... pointers, and dynamically generates Definition subclasses for each type.

A2A::Protocol::JsonSchema["Agent Capabilities"]
#=> Class < Definition with .schema, .valid?, reader methods

A2A::Protocol::JsonSchema["Agent Card"]
#=> Class < Definition

A2A::Protocol::JsonSchema.list_definitions
#=> ["API Key Security Scheme", "Agent Capabilities", ...]

Defined Under Namespace

Classes: Definition, ValidationError

Constant Summary collapse

DATA_PATH = 
File.expand_path("../../../data/a2a.json", __dir__).freeze

Class Method Summary collapse

Class Method Details

.[](name) ⇒ Object

Look up a definition by title.

A2A::Protocol::JsonSchema["Agent Capabilities"]
#=> Class < Definition


37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/a2a/protocol/json_schema.rb', line 37

def [](name)
  @definition_classes[name] ||= begin
    definitions = raw_schema.fetch("definitions", {})

    unless definitions.key?(name)
      raise "No A2A definition found for #{name.inspect}!" \
        "\nAvailable: #{list_definitions.join(", ")}"
    end

    encoded = URI::DEFAULT_PARSER.escape(name)
    ref_schema = schemer.ref("#/definitions/#{encoded}")
    build_definition_class(ref_schema, name, definitions[name])
  end
end

.list_definitions ⇒ Object

All available definition titles, sorted.

A2A::Protocol::JsonSchema.list_definitions
#=> ["API Key Security Scheme", "Agent Capabilities", ...]


57
58
59
 
# File 'lib/a2a/protocol/json_schema.rb', line 57

def list_definitions
  raw_schema.fetch("definitions", {}).keys.sort
end

.raw_schema ⇒ Object

The parsed + ref-rewritten JSON schema hash.



68
69
70
 
# File 'lib/a2a/protocol/json_schema.rb', line 68

def raw_schema
  @raw_schema ||= load_and_rewrite_schema
end

.reset! ⇒ Object

Reset all cached state (useful for tests).



73
74
75
76
77
78
 
# File 'lib/a2a/protocol/json_schema.rb', line 73

def reset!
  @definition_classes.clear
  @schemer = nil
  @raw_schema = nil
  @ref_map = nil
end

.schemer ⇒ Object

The JSONSchemer instance for the full A2A schema bundle. Cached after first access.



63
64
65
 
# File 'lib/a2a/protocol/json_schema.rb', line 63

def schemer
  @schemer ||= JSONSchemer.schema(raw_schema)
end