docs: Improve screenshot and CSV writing skills with artifact integra…

.flox/env/manifest.toml

@@ -5,20 +5,24 @@ go.pkg-path = "go"
 go.version = "1.25"
 
 golangci-lint.pkg-path = "golangci-lint"
-golangci-lint.version = "^2.4.0"
+golangci-lint.version = "2.5.0"
 golangci-lint.pkg-group = "common"
 
 go-task.pkg-path = "go-task"
+go-task.version = "^3.45.4"
 go-task.pkg-group = "common"
 
 git.pkg-path = "git"
+git.version = "2.51.0"
 git.pkg-group = "common"
 
 docker.pkg-path = "docker"
+docker.version = "28.4.0"
 docker.pkg-group = "common"
 
 claude-code.pkg-path = "claude-code"
 claude-code.pkg-group = "common"
+claude-code.version = "^2.0.1"
 
 [hook]
 on-activate = '''

CLAUDE.md

@@ -10,7 +10,7 @@ browser-agent is an A2A (Agent-to-Agent) server implementing the [A2A Protocol](
 
 ### ADL-Generated Structure
 
-The codebase is generated using ADL CLI 0.22.1 and follows a strict generation pattern:
+The codebase is generated using ADL CLI 0.23.0 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`
@@ -118,7 +118,7 @@ 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.22.1 or compatible version for regeneration
+- **ADL Version**: Ensure ADL CLI 0.23.0 or compatible version for regeneration
 - **Port Configuration**: Default 8080, configurable via `A2A_PORT` or `A2A_SERVER_PORT`
 
 ## Debugging Tips

example/README.md

@@ -26,7 +26,7 @@ docker compose run --rm cli
 Ask the following:
 
 ```text
-Please visit http://demo-site and take a screenshot of the homepage. Use the agent.
+Please visit http://demo-site which is running locally and take a screenshot of the homepage. Use the agent.
 ```
 
 You would see the CLI (A2A agent client) submitting a task to the A2A agent server and the screenshot will appear in the `screenshots` directory since it's mounted as a volume.
@@ -37,6 +37,12 @@ Check the logs to see that the browser indeed went to the demo site and took a s
 docker compose logs -f demo-site
 ```
 
+Also you can check the task was successfully submitted to the agent and it's available using the a2a debugger:
+
+```bash
+docker compose run --rm a2a-debugger tasks list
+```
+
 Finally clean up:
 
 ```bash

example/docker-compose.yaml

@@ -5,6 +5,10 @@ services:
       context: ..
       dockerfile: Dockerfile
     container_name: agent
+    ports:
+      - 8081:8081
+    volumes:
+      - ./artifacts:/tmp/artifacts
     environment:
       BROWSER_USER_AGENT: "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
       BROWSER_VIEWPORT_WIDTH: "1920"
@@ -61,13 +65,12 @@ services:
       A2A_QUEUE_CLEANUP_INTERVAL: 500s
       A2A_AUTH_ENABLE: false
       A2A_ARTIFACTS_ENABLE: true
-      A2A_ARTIFACTS_SERVER_HOST: localhost
+      A2A_ARTIFACTS_SERVER_HOST: agent
       A2A_ARTIFACTS_SERVER_PORT: 8081
       A2A_ARTIFACTS_STORAGE_PROVIDER: filesystem
-      A2A_ARTIFACTS_STORAGE_BASE_PATH: ./artifacts
-      A2A_ARTIFACTS_STORAGE_BASE_URL: http://agent:8081
+      A2A_ARTIFACTS_STORAGE_BASE_PATH: /tmp/artifacts
       A2A_ARTIFACTS_RETENTION_MAX_ARTIFACTS: 10
-      A2A_ARTIFACTS_RETENTION_MAX_AGE: 7d
+      A2A_ARTIFACTS_RETENTION_MAX_AGE: 24h
       A2A_ARTIFACTS_RETENTION_CLEANUP_INTERVAL: 24h
     networks:
       - a2a-network
@@ -91,7 +94,7 @@ services:
     image: ghcr.io/inference-gateway/cli:latest
     pull_policy: always
     volumes:
-      - ./downloads:/tmp/artifacts
+      - ./downloads:/tmp/downloads
     environment:
       INFER_LOGGING_DEBUG: true
       INFER_GATEWAY_URL: http://inference-gateway:8080
@@ -100,7 +103,7 @@ services:
       INFER_AGENT_MODEL: deepseek/deepseek-chat
       INFER_A2A_AGENTS: |
         http://agent:8080
-      INFER_DOWNLOAD_DIR: /tmp/artifacts
+      INFER_DOWNLOAD_DIR: /tmp/downloads
     command:
       - chat
     networks: