Integrate jsoncons for robust JSON schema validation

agent_sdks/conformance/README.md

@@ -3,9 +3,20 @@
 To ensure behavioral parity across all SDK implementations (Python, Kotlin, etc.), the project maintains a language-agnostic conformance suite in this directory.
 
 ## Suite Structure
-*   `parser.yaml`: Contains test cases for the `A2uiStreamParser`, verifying chunk buffering, incremental yielding, and edge cases like cut tokens.
-*   `validator.yaml`: Contains test cases for the `A2uiValidator`, verifying structural integrity, cycle detection, and reachability.
-*   `conformance_schema.json`: The JSON schema that validates the structure of the YAML test files themselves.
+All test suites are located in the `suites/` directory:
+*   `suites/streaming_parser.yaml`: Contains test cases for the `A2uiStreamParser` (streaming), verifying chunk buffering, incremental yielding, and edge cases like cut tokens.
+*   `suites/parser.yaml`: Contains test cases for non-streaming parsing and payload fixing.
+*   `suites/validator.yaml`: Contains test cases for the `A2uiValidator`, verifying structural integrity, cycle detection, and reachability.
+*   `suites/catalog.yaml`: Contains test cases for `A2uiCatalog` (prune, render, load).
+*   `suites/schema_manager.yaml`: Contains test cases for `A2uiSchemaManager` (select_catalog, load_catalog, generate_prompt).
+
+All static test data and simplified schemas are located in the `test_data/` directory.
+
+`conformance_schema.json` at the root is the JSON schema that validates the structure of the YAML test files themselves.
+
+
+
+
 
 ## Usage in SDKs
 Each language SDK must implement a test harness that:

agent_sdks/conformance/conformance_schema.json

@@ -20,29 +20,53 @@
         "properties": {
           "version": {
             "type": "string",
-            "enum": ["0.8", "0.9"],
+            "enum": [
+              "0.8",
+              "0.9"
+            ],
             "description": "Protocol version."
           },
           "s2c_schema": {
             "oneOf": [
-              { "type": "string", "description": "Path to simplified schema file." },
-              { "type": "object", "description": "Inlined schema object." }
+              {
+                "type": "string",
+                "description": "Path to simplified schema file."
+              },
+              {
+                "type": "object",
+                "description": "Inlined schema object."
+              }
             ]
           },
           "catalog_schema": {
             "oneOf": [
-              { "type": "string", "description": "Path to catalog file." },
-              { "type": "object", "description": "Inlined catalog object." }
+              {
+                "type": "string",
+                "description": "Path to catalog file."
+              },
+              {
+                "type": "object",
+                "description": "Inlined catalog object."
+              }
             ]
           },
           "common_types_schema": {
             "oneOf": [
-              { "type": "string", "description": "Path to common types schema file." },
-              { "type": "object", "description": "Inlined common types schema object." }
+              {
+                "type": "string",
+                "description": "Path to common types schema file."
+              },
+              {
+                "type": "object",
+                "description": "Inlined common types schema object."
+              }
             ]
           }
         },
-        "required": ["version", "s2c_schema", "catalog_schema"]
+        "required": [
+          "version"
+        ]
+
       },
       "process_chunk": {
         "type": "array",
@@ -60,8 +84,15 @@
               "items": {
                 "type": "object",
                 "properties": {
-                  "text": { "type": "string" },
-                  "a2ui": { "type": "array", "items": { "type": "object" } }
+                  "text": {
+                    "type": "string"
+                  },
+                  "a2ui": {
+                    "type": "array",
+                    "items": {
+                      "type": "object"
+                    }
+                  }
                 }
               }
             },
@@ -70,10 +101,20 @@
               "description": "Expected error message (regex) if this step should fail."
             }
           },
-          "required": ["input"],
+          "required": [
+            "input"
+          ],
           "oneOf": [
-            { "required": ["expect"] },
-            { "required": ["expect_error"] }
+            {
+              "required": [
+                "expect"
+              ]
+            },
+            {
+              "required": [
+                "expect_error"
+              ]
+            }
           ]
         }
       },
@@ -85,8 +126,15 @@
           "properties": {
             "payload": {
               "oneOf": [
-                { "type": "object" },
-                { "type": "array", "items": { "type": "object" } }
+                {
+                  "type": "object"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "object"
+                  }
+                }
               ],
               "description": "Payload to validate (single message or list of messages)."
             },
@@ -95,14 +143,95 @@
               "description": "Expected error message (regex) if validation should fail."
             }
           },
-          "required": ["payload"]
+          "required": [
+            "payload"
+          ]
         }
+      },
+      "action": {
+        "type": "string",
+        "description": "Action for general conformance tests (e.g., prune, render, select_catalog)."
+      },
+      "args": {
+        "type": "object",
+        "description": "Arguments for the action."
+      },
+      "expect": {
+        "description": "Expected output for the action."
+      },
+      "expect_contains": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "List of substrings expected in the output."
+      },
+      "expect_output": {
+        "type": "string",
+        "description": "Expected raw string output."
+      },
+      "input": {
+        "type": "string",
+        "description": "Input for single-step tests."
       }
     },
-    "required": ["name", "catalog"],
-    "oneOf": [
-      { "required": ["process_chunk"] },
-      { "required": ["validate"] }
+    "required": [
+      "name"
+    ],
+    "anyOf": [
+      {
+
+        "required": [
+          "process_chunk",
+          "catalog"
+        ],
+        "properties": {
+          "catalog": {
+            "required": [
+              "s2c_schema",
+              "catalog_schema"
+            ]
+          }
+        }
+      },
+      {
+        "required": [
+          "validate",
+          "catalog"
+        ],
+        "properties": {
+          "catalog": {
+            "required": [
+              "s2c_schema",
+              "catalog_schema"
+            ]
+          }
+        }
+      },
+
+      {
+        "required": [
+          "action"
+        ]
+      },
+      {
+        "required": [
+          "input"
+        ],
+        "oneOf": [
+          {
+            "required": [
+              "expect"
+            ]
+          },
+          {
+            "required": [
+              "expect_error"
+            ]
+          }
+        ]
+      }
     ]
+
   }
-}
+}