diff --git a/.gitattributes b/.gitattributes index 51fea8e..96bd293 100644 --- a/.gitattributes +++ b/.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 diff --git a/.github/workflows/cd.yml b/.github/workflows/cd.yml index e2ebcf1..b8092c2 100644 --- a/.github/workflows/cd.yml +++ b/.github/workflows/cd.yml @@ -1,4 +1,4 @@ -# Code generated by ADL CLI v0.21.4. DO NOT EDIT. +# Code generated by ADL CLI v0.21.6. DO NOT EDIT. # This file was automatically generated from an ADL (Agent Definition Language) specification. # Manual changes to this file may be overwritten during regeneration. diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index b9a0422..20ea025 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -1,4 +1,4 @@ -# Code generated by ADL CLI v0.21.4. DO NOT EDIT. +# Code generated by ADL CLI v0.21.6. DO NOT EDIT. # This file was automatically generated from an ADL (Agent Definition Language) specification. # Manual changes to this file may be overwritten during regeneration. diff --git a/.gitignore b/.gitignore index 07b5fdc..7f692b4 100644 --- a/.gitignore +++ b/.gitignore @@ -40,7 +40,7 @@ Thumbs.db # Environment files .env* -!.env.*.example +!.env*.example # Log files *.log diff --git a/.releaserc.yaml b/.releaserc.yaml index a022ad3..c8e2084 100644 --- a/.releaserc.yaml +++ b/.releaserc.yaml @@ -1,4 +1,4 @@ -# Code generated by ADL CLI v0.21.4. DO NOT EDIT. +# Code generated by ADL CLI v0.21.6. DO NOT EDIT. # This file was automatically generated from an ADL (Agent Definition Language) specification. # Manual changes to this file may be overwritten during regeneration. @@ -99,7 +99,7 @@ plugins: - main.go - README.md - Taskfile.yml - - .well-known/agent.json + - .well-known/agent-card.json message: "chore(release): 🔖 ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}" - - '@semantic-release/github' diff --git a/.well-known/agent.json b/.well-known/agent-card.json similarity index 100% rename from .well-known/agent.json rename to .well-known/agent-card.json diff --git a/AGENTS.md b/AGENTS.md index 6cafe59..22f3905 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 ``` diff --git a/CLAUDE.md b/CLAUDE.md index 55d1395..45b8364 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 diff --git a/Dockerfile b/Dockerfile index 4e9c929..d8710ac 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,4 +1,4 @@ -# Code generated by ADL CLI v0.21.4. DO NOT EDIT. +# Code generated by ADL CLI v0.21.6. DO NOT EDIT. # This file was automatically generated from an ADL (Agent Definition Language) specification. # Manual changes to this file may be overwritten during regeneration. diff --git a/README.md b/README.md index e0f1b4f..767c321 100644 --- a/README.md +++ b/README.md @@ -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 | - | diff --git a/Taskfile.yml b/Taskfile.yml index fa1f5b9..827e27a 100644 --- a/Taskfile.yml +++ b/Taskfile.yml @@ -1,4 +1,4 @@ -# Code generated by ADL CLI v0.21.4. DO NOT EDIT. +# Code generated by ADL CLI v0.21.6. DO NOT EDIT. # This file was automatically generated from an ADL (Agent Definition Language) specification. # Manual changes to this file may be overwritten during regeneration. diff --git a/config/config.go b/config/config.go index c81fe2e..042d525 100644 --- a/config/config.go +++ b/config/config.go @@ -1,4 +1,4 @@ -// Code generated by ADL CLI v0.21.4. DO NOT EDIT. +// Code generated by ADL CLI v0.21.6. DO NOT EDIT. // This file was automatically generated from an ADL (Agent Definition Language) specification. // Manual changes to this file may be overwritten during regeneration. diff --git a/internal/logger/logger.go b/internal/logger/logger.go index 578ab6c..33b14ec 100644 --- a/internal/logger/logger.go +++ b/internal/logger/logger.go @@ -1,4 +1,4 @@ -// Code generated by ADL CLI v0.21.4. DO NOT EDIT. +// Code generated by ADL CLI v0.21.6. DO NOT EDIT. // This file was automatically generated from an ADL (Agent Definition Language) specification. // Manual changes to this file may be overwritten during regeneration. diff --git a/main.go b/main.go index f4a857b..087b5ac 100644 --- a/main.go +++ b/main.go @@ -1,4 +1,4 @@ -// Code generated by ADL CLI v0.21.4. DO NOT EDIT. +// Code generated by ADL CLI v0.21.6. DO NOT EDIT. // This file was automatically generated from an ADL (Agent Definition Language) specification. // Manual changes to this file may be overwritten during regeneration. @@ -74,7 +74,7 @@ func main() { a2aServer, err := server.NewA2AServerBuilder(cfg.A2A, l). WithAgent(agent). - WithAgentCardFromFile(".well-known/agent.json", map[string]any{ + WithAgentCardFromFile(".well-known/agent-card.json", map[string]any{ "name": AgentName, "version": Version, "description": AgentDescription,