Refactor AI-Agents service integration: rename endpoints, move ai_description to Itinerary

[Copilot]

Aligns AI-Agents service integration with proper REST semantics and data model. Moves AI description from response-level to itinerary-level where it belongs, and renames /insights/route to /insight/leg to reflect what's actually being described.

Schema Changes

• Itinerary schema: Added optional ai_description field for AI-generated itinerary summaries
• RouteSearchResponse schema: Removed ai_description (now lives on each Itinerary)

Service Layer

• Renamed: get_route_insight() → get_leg_insight()
• Endpoint: /insights/route → /api/v1/insight/leg
• New method: get_itinerary_insight() calls /api/v1/insight/itinerary

Both methods gracefully degrade on failure (return None), maintaining service availability when AI-Agents is unavailable.

Route Endpoint

The /route/search endpoint now enriches responses with two AI calls per itinerary:

# For each itinerary
itinerary.ai_description = await ai_agents_service.get_itinerary_insight(itinerary)

# For each leg in itinerary
leg.ai_insight = await ai_agents_service.get_leg_insight(leg)

All AI enrichment is wrapped in try-except for graceful degradation.

Tests

Added 6 tests for get_itinerary_insight(). Updated existing tests to reflect renamed methods and new endpoint paths.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Integrate AI-Agents Service Client</issue_title>
<issue_description>- HTTP client configured to communicate with ai-agents service

• Integrate /route/search endpoint with ai-agents service
  • Update itinerary schema with optional (nullable) ai_description which we acquire using api/v1/insight/itinerary in get_itinerary_insight
  • Remove ai_description from RouteSearchResponse
  • Refactor get_route_insight to use proper nomenclature of get_leg_insight and api/v1/insight/leg route
• Service client handles connection errors gracefully
• Handles failures gracefully</issue_description>

<agent_instructions>Update tests accordingly</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@zlendo1 Closed with #30 @zlendo1 Wrongfully closed, reconfigured structure

• Fixes Integrate AI-Agents Service Client #21

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.