Update agent score contract docs

[adrunkhuman]

Summary

• Update AGENTS.md to document the current POST /score response contract with heatmap_url.
• Add the GET /heatmap route contract so agent guidance matches README.md and the tests.

Testing

• Commit hooks: ty type checker, pytest