{"openapi":"3.0.3","info":{"title":"SchemaHarmonizer-A2A","description":"Autonomous Syntactic AST Schema Normalizer & High-Throughput JSON Drift Repair Gate for Enterprise Agent Fleets","version":"1.0.0","contact":{"name":"A2A Swarm Engineering","url":"https://a2aregistry.org/agents/schema-harmonizer-a2a"}},"servers":[{"url":"https://schema-harmonizer-a2a-861341012353.us-central1.run.app","description":"Production Cloud Run Serverless Gateway (us-central1)"}],"paths":{"/health":{"get":{"summary":"Service Health Probe","operationId":"getHealth","responses":{"200":{"description":"Service healthy and ready","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"UP"},"service":{"type":"string","example":"schema-harmonizer-a2a"},"version":{"type":"string","example":"1.0.0"},"runtime":{"type":"string","example":"x86_64-unknown-linux-musl"},"zero_python":{"type":"boolean","example":true}}}}}}}}},"/probe":{"get":{"summary":"Liveness and Readiness Health Probe","operationId":"getProbe","responses":{"200":{"description":"Service healthy and ready","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"UP"},"service":{"type":"string","example":"schema-harmonizer-a2a"},"version":{"type":"string","example":"1.0.0"},"runtime":{"type":"string","example":"x86_64-unknown-linux-musl"},"zero_python":{"type":"boolean","example":true}}}}}}}}},"/.well-known/agent-card.json":{"get":{"summary":"A2A 0.3.0 Standard Agent Card","operationId":"getAgentCard","responses":{"200":{"description":"Agent Card metadata defining identity, capabilities, and skills","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/harmonize":{"post":{"summary":"Harmonize and Repair Malformed Payload","operationId":"harmonizePayload","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HarmonizeRequest"}}}},"responses":{"200":{"description":"Canonical RFC 8785 AST and Proof-of-Erasure receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HarmonizeResponse"}}}},"400":{"description":"Validation or parsing error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/v1/verify":{"post":{"summary":"Verify Payload Conformance against Schema","operationId":"verifyPayload","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"}}}},"responses":{"200":{"description":"Verification result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}}}}},"/message/send":{"post":{"summary":"A2A JSON-RPC 2.0 Ingress Endpoint","operationId":"sendA2AMessage","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","example":"2.0"},"method":{"type":"string","example":"harmonize"},"params":{"type":"object"},"id":{"type":"string","example":"req-001"}}}}}},"responses":{"200":{"description":"A2A JSON-RPC 2.0 Response","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"HarmonizeRequest":{"type":"object","required":["raw_payload","target_schema"],"properties":{"raw_payload":{"type":"string","description":"Corrupted or drifted JSON payload string"},"target_schema":{"type":"object","description":"Target JSON Schema Draft-07 specification"},"options":{"type":"object","properties":{"allow_llm_fallback":{"type":"boolean","default":true},"max_levenshtein_distance":{"type":"integer","default":2},"client_nonce":{"type":"string"}}}}},"HarmonizeResponse":{"type":"object","properties":{"status":{"type":"string","example":"harmonized"},"canonical_ast":{"type":"object"},"ast_hash":{"type":"string"},"execution_metrics":{"type":"object","properties":{"tier_used":{"type":"integer","example":1},"total_duration_ms":{"type":"number","example":4.2},"casing_mutations":{"type":"integer","example":3},"levenshtein_fixes":{"type":"integer","example":1},"type_coercions":{"type":"integer","example":2}}},"proof_of_erasure":{"type":"object","properties":{"ast_hash":{"type":"string"},"timestamp_ns":{"type":"integer"},"client_nonce":{"type":"string"},"signature":{"type":"string"},"public_key":{"type":"string"}}}}},"VerifyRequest":{"type":"object","required":["payload","schema"],"properties":{"payload":{"type":"object"},"schema":{"type":"object"}}},"VerifyResponse":{"type":"object","properties":{"conforms":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}},"ProblemDetails":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"error_code":{"type":"string"},"ast_errors":{"type":"array","items":{"type":"string"}}}}}}}