Add disaster response coordination agent (Agent Kernel + Gemini)

[Jenitha23]

Description

Adds a Gemini-powered submission for the IDEALIZE 2026 Agent Kernel mini-competition: a
three-agent Disaster Response & Resource Coordination system (intake → priority/matching →
dedup/dispatch) that parses free-form need/offer messages, scores urgency, matches across
regions with distance/transport awareness, deduplicates, and dispatches a WhatsApp notification.

Type of Change

• New feature (non-breaking change which adds functionality)
• Documentation update
• Test update

Related Issues

Fixes #
Relates to #

Changes Made

• Added use-cases/disaster-response-agent/: a 3-agent Agent Kernel pipeline
  (intake_agent → priority_matching_agent → dedup_dispatch_agent) built on the OpenAI
  Agents SDK integration, using Gemini (gemini-3.1-flash-lite) via LiteLLM's native
  integration for all LLM calls
• Implemented cross-region resource matching weighted by quantity coverage, proximity/distance,
  and transport compatibility ("no transport" / "can deliver" signals detected from message text)
• Added duplicate detection/merging and a (dummy-mode by default, real-mode configurable)
  WhatsApp dispatch notification, with automatic retry/backoff on rate-limited LLM calls
• Added demo.py (canonical CLI entry point) and api.py (REST API entry point)
• Added tests/test_tool_layer.py (32 deterministic unit tests) and tests/test_agent_e2e.py
  (live conversational test via agentkernel.test.Test, skipped automatically without a
  GEMINI_API_KEY), plus test-config.yaml
• Added SPEC.md and README.md covering the problem, architecture, agent/tool
  responsibilities, memory design, SDG alignment, setup (including Windows-specific notes),
  and limitations

Testing

• Unit tests pass locally
• Integration tests pass locally
• Manual testing completed
• New tests added for changes

Ran uv run pytest locally: 32 passed, 3 skipped (the live end-to-end tests, which require a
GEMINI_API_KEY). Manually tested the full pipeline via python demo.py against the real
Gemini API, including the cross-region/no-transport matching scenario.

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published

Screenshots (if applicable)

N/A

Additional Notes

Built for the IDEALIZE 2026 mini-competition (AIESEC in University of Moratuwa / Yaala Labs).
Addresses SDG 11 (Sustainable Cities and Communities) and SDG 13 (Climate Action).