refactor: move JSON schema to separate file

- Extract agent configuration schema to schemas/agent-config-v1.json
- Add _load_schema() function to load schema from file at runtime
- Improve code readability by separating schema from Python logic
- Enable schema reuse by other tools and documentation
- Maintain all existing validation functionality and tests

🤖 Assisted by Amazon Q Developer

Author: mrlee-amazon

src/strands/experimental/agent_config.py

@@ -11,39 +11,12 @@
 
 from ..agent import Agent
 
-# JSON Schema for agent configuration
-AGENT_CONFIG_SCHEMA = {
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "title": "Agent Configuration",
-    "description": "Configuration schema for creating agents",
-    "type": "object",
-    "properties": {
-        "name": {
-            "description": "Name of the agent",
-            "type": ["string", "null"],
-            "default": None
-        },
-        "model": {
-            "description": "The model ID to use for this agent. If not specified, uses the default model.",
-            "type": ["string", "null"],
-            "default": None
-        },
-        "prompt": {
-            "description": "The system prompt for the agent. Provides high level context to the agent.",
-            "type": ["string", "null"],
-            "default": None
-        },
-        "tools": {
-            "description": "List of tools the agent can use. Can be module paths, file paths, or tool names.",
-            "type": "array",
-            "items": {
-                "type": "string"
-            },
-            "default": []
-        }
-    },
-    "additionalProperties": False
-}
+
+def _load_schema() -> dict:
+    """Load the agent configuration schema from file."""
+    schema_path = Path(__file__).parent / "schemas" / "agent-config-v1.json"
+    with open(schema_path, 'r') as f:
+        return json.load(f)
 
 
 def config_to_agent(config: str | dict[str, any], **kwargs) -> Agent:
@@ -95,7 +68,8 @@ def config_to_agent(config: str | dict[str, any], **kwargs) -> Agent:
 
     # Validate configuration against schema
     try:
-        jsonschema.validate(config_dict, AGENT_CONFIG_SCHEMA)
+        schema = _load_schema()
+        jsonschema.validate(config_dict, schema)
     except ValidationError as e:
         # Provide more detailed error message
         error_path = " -> ".join(str(p) for p in e.absolute_path) if e.absolute_path else "root"

src/strands/experimental/schemas/agent-config-v1.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Agent Configuration",
+  "description": "Configuration schema for creating agents",
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "Name of the agent",
+      "type": ["string", "null"],
+      "default": null
+    },
+    "model": {
+      "description": "The model ID to use for this agent. If not specified, uses the default model.",
+      "type": ["string", "null"],
+      "default": null
+    },
+    "prompt": {
+      "description": "The system prompt for the agent. Provides high level context to the agent.",
+      "type": ["string", "null"],
+      "default": null
+    },
+    "tools": {
+      "description": "List of tools the agent can use. Can be module paths, file paths, or tool names.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "additionalProperties": false
+}