Codex sandbox task: agentkit-sdk-python

[xgtcode]

Summary

Fix AgentkitAgentServerApp not supporting a custom public URL for the AgentCard.

Problem

AgentkitAgentServerApp called to_a2a(agent=root_agent, runner=runner) without passing host, port, or protocol, so the AgentCard url (served at /.well-known/agent-card) was always hardcoded to http://localhost:8000 — even when the server was deployed behind a reverse proxy or on a different host/port.

Solution

• Add an optional public_url: str | None = None keyword argument to AgentkitAgentServerApp.__init__.
• When provided, the URL is parsed via urllib.parse.urlparse into protocol, host, and port (defaulting to 443 for https / 80 for http when no explicit port is given) and forwarded to to_a2a.
• When None (default), behaviour is unchanged — full backward compatibility.
• Validates that the URL contains a scheme and hostname, raising ValueError otherwise.

Tests

Added tests/apps/test_agent_server_public_url.py with 6 test cases:

• Default (no public_url) → http://localhost:8000
• Custom https with port → https://agent.example.com:8443
• Custom http without port → http://agent.example.com:80
• Custom https without port → https://agent.example.com:443
• Missing scheme raises ValueError
• Missing hostname raises ValueError

All 199 tests in tests/apps pass.

Changed files

• agentkit/apps/agent_server_app/agent_server_app.py — added public_url param
• tests/apps/test_agent_server_public_url.py — new test file