feat(market-research-agent): add multi-agent market research sample

[nikhithajoy]

Summary

• Adds a new multi-agent market research sample using Google ADK
• Orchestrator LlmAgent coordinates 4 specialist agents (competitor, location, traffic, gap analysis) in parallel via AgentTool
• Uses Google Places API as FunctionTools for real-world location data

Agent Details

Feature	Description
Interaction Type	Conversational
Complexity	Advanced
Agent Type	Multi Agent
Components	LlmAgent, AgentTool, FunctionTool, Google Places API
Vertical	Retail / Business Analytics

Test plan

• uv sync installs without errors
• uv run adk web starts the agent successfully
• Agent geocodes address, runs 4 sub-agents in parallel, returns market report
• uv run pytest tests/ -v passes

[nikhithajoy]

Hi @norarfilali, @hupili, would appreciate a review when you get a chance! This adds a multi-agent market research sample using Google Places API + ADK.

[happyhuman]

Hi @nikhithajoy, this PR has been open for 106 days without recent activity. Some of the files it touches have been restructured on main in the interim. Are you still interested in continuing this? If we don't hear back within the next 14 days, we'll close this PR for housekeeping — please feel free to reopen anytime if you'd like to pick it back up. Thanks for the contribution!

(auto-managed by repo housekeeping — nudge id: cloudcode-2wk-nudge-2026-07-28)

[happyhuman]

Please take a look at the docs to learn more about the new quality standards for the samples/recipes. There has been a ton of changes and the old samples are not acceptable anymore.

[nikhithajoy]

Hi @happyhuman,
Thanks for the pointer to the docs. I've updated this PR to match the new contrib/ recipe standard:

• Moved the recipe from python/agents/market-research-agent to contrib/python/market-research-agent
• Added manifest.yaml and tests/test_runnability.py
• Renamed the package to app/ per the new convention
• Aligned pyproject.toml (Python 3.11 floor, no local ruff config, public PyPI index)
• Moved load_dotenv() into app/__init__.py

Ran uv run validate structure/manifest/readme, ruff format/ruff check, and pytest locally against the current repo tooling - all passing. Also rebased onto current main since the branch was quite far behind.

Ready for another look whenever you get a chance. Please let me know if I've missed anything from the new checklist.

[happyhuman]

Great work. Thanks. Just left 1 minor comment.

[happyhuman]

Can you please add a real team here?

[nikhithajoy]

I'm contributing this as an individual, not on behalf of a formal team. Could you elaborate on what kind of team name I should add here?

[happyhuman]

I see. The reason we introduced team was to make sure no sample/recipe will become orphaned (since we had to deal with a number of them before). We wanted to make sure a team owns the recipe in case the poc leaves. If you think you will be able to remain the owner and continue to maintain it, we can accept you as the team.

[nikhithajoy]

That makes sense, thanks for explaining. Yes, I plan to remain the owner and maintain this recipe going forward.

[happyhuman]

Oh okay. Sounds good. I will approve your PR.
Congratulations on submitting the very first recipe to our newly restructured contrib/python by the way. :-)

[nikhithajoy]

Thank you so much. Really appreciate you taking the time to review and guide me.

[happyhuman]

Perhaps you want to change these 2025 years to 2026?

[nikhithajoy]

Yeah, updated to 2026 across all files in the recipe. Please check.