refactor: Update ADL CLI version to 0.21.6 and modify agent metadata file references (#8)

* refactor: Update ADL CLI version to 0.21.6 and modify agent metadata file references

Signed-off-by: Eden Reich <[email protected]>

* refactor: Remove deprecated agent metadata file

Signed-off-by: Eden Reich <[email protected]>

---------

Signed-off-by: Eden Reich <[email protected]>

Author: edenreich

.gitattributes

@@ -20,7 +20,7 @@ k8s/*.yaml linguist-generated=true
 k8s/*.yml linguist-generated=true
 
 # Agent capabilities
-.well-known/agent.json linguist-generated=true
+.well-known/agent-card.json linguist-generated=true
 
 # Documentation (partially generated)
 README.md linguist-documentation=true

.github/workflows/cd.yml

@@ -80,7 +80,7 @@ This agent provides 2 skills:
 
 The agent exposes the following HTTP endpoints:
 
-- `GET /.well-known/agent.json` - Agent metadata and capabilities
+- `GET /.well-known/agent-card.json` - Agent metadata and capabilities
 - `POST /skills/{skill_name}` - Execute a specific skill
 - `GET /skills/{skill_name}/stream` - Stream skill execution results
 - `GET /history` - Retrieve agent state transition history
@@ -125,7 +125,7 @@ The agent implements the A2A protocol and can be communicated with via HTTP requ
 
 ```bash
 # Get agent information
-curl http://localhost:8080/.well-known/agent.json
+curl http://localhost:8080/.well-known/agent-card.json
 
 
 
@@ -175,7 +175,7 @@ docker run -p 8080:8080 documentation-agent
 │   └── get_library_docs.go   # Fetches up-to-date documentation for a library using Context7-compatible library ID
 
 ├── .well-known/         # Agent configuration
-│   └── agent.json       # Agent metadata
+│   └── agent-card.json  # Agent metadata
 ├── go.mod               # Go module definition
 └── README.md            # Project documentation
 ```

.github/workflows/ci.yml

@@ -10,7 +10,7 @@ documentation-agent is an A2A (Agent-to-Agent) server implementing the [A2A Prot
 
 ### ADL-Generated Structure
 
-The codebase is generated using ADL CLI 0.21.4 and follows a strict generation pattern:
+The codebase is generated using ADL CLI 0.21.6 and follows a strict generation pattern:
 - **Generated Files**: Marked with `DO NOT EDIT` headers - manual changes will be overwritten
 - **Configuration Source**: `agent.yaml` - defines agent capabilities, skills, and metadata
 - **Server Implementation**: Built on the ADK (Agent Development Kit) framework from `github.com/inference-gateway/adk`
@@ -23,7 +23,7 @@ The codebase is generated using ADL CLI 0.21.4 and follows a strict generation p
   - A2A server with streaming and background task handlers
   - Graceful shutdown handling
 
-- **Agent Configuration**: `.well-known/agent.json` - Serves agent metadata at runtime
+- **Agent Configuration**: `.well-known/agent-card.json` - Serves agent metadata at runtime
 - **Environment Configuration**: Extensive env vars with `A2A_` prefix (see README for full list)
 
 ## Development Commands
@@ -111,13 +111,13 @@ Activate with: `flox activate` (if Flox is installed)
 
 - **Generated Files**: Never manually edit files with "DO NOT EDIT" headers
 - **Configuration Changes**: Always modify `agent.yaml` and regenerate
-- **ADL Version**: Ensure ADL CLI 0.21.4 or compatible version for regeneration
+- **ADL Version**: Ensure ADL CLI 0.21.6 or compatible version for regeneration
 - **Port Configuration**: Default 8080, configurable via `A2A_PORT` or `A2A_SERVER_PORT`
 
 ## Debugging Tips
 
 - Enable debug mode: `A2A_DEBUG=true`
 - Check health: `GET /health`
-- View agent metadata: `GET /.well-known/agent.json`
+- View agent metadata: `GET /.well-known/agent-card.json`
 - Monitor streaming updates: Set `A2A_STREAMING_STATUS_UPDATE_INTERVAL`
 - Use A2A Debugger container for interactive testing

.gitignore

@@ -34,7 +34,7 @@ docker run -p 8080:8080 documentation-agent
 
 ## Endpoints
 
-- `GET /.well-known/agent.json` - Agent metadata and capabilities
+- `GET /.well-known/agent-card.json` - Agent metadata and capabilities
 - `GET /health` - Health check endpoint
 - `POST /a2a` - A2A protocol endpoint
 
@@ -59,7 +59,7 @@ Configure the agent via environment variables:
 | **Server** | `A2A_SERVER_WRITE_TIMEOUT` | HTTP server write timeout | `120s` |
 | **Server** | `A2A_SERVER_IDLE_TIMEOUT` | HTTP server idle timeout | `120s` |
 | **Server** | `A2A_SERVER_DISABLE_HEALTHCHECK_LOG` | Disable logging for health check requests | `true` |
-| **Agent Metadata** | `A2A_AGENT_CARD_FILE_PATH` | Path to agent card JSON file | `.well-known/agent.json` |
+| **Agent Metadata** | `A2A_AGENT_CARD_FILE_PATH` | Path to agent card JSON file | `.well-known/agent-card.json` |
 | **LLM Client** | `A2A_AGENT_CLIENT_PROVIDER` | LLM provider (`openai`, `anthropic`, `azure`, `ollama`, `deepseek`) |`` |
 | **LLM Client** | `A2A_AGENT_CLIENT_MODEL` | Model to use |`` |
 | **LLM Client** | `A2A_AGENT_CLIENT_API_KEY` | API key for LLM provider | - |