Clinical Trial Finder ability

[hassan1731996]

What this adds

community/clinical-trial-finder/ — voice-first search for recruiting clinical trials via the ClinicalTrials.gov REST API v2.

Trigger phrases

• "find clinical trials for Parkinson's"
• "any trials near me for diabetes?"
• "find medical studies for breast cancer in Boston"

Within a session

• Say "2" to get details on trial Official updates from the OpenHome team #2
• Say "requirements" for eligibility summary (LLM-distilled to 2 spoken sentences)
• Say "contact" for coordinator name, phone, email
• Say "save" to add to personal watchlist
• Say "more" for next page of results

Architecture

• main.py — 7-intent LLM router (SEARCH, DETAILS, ELIGIBILITY, CONTACT, SAVE, MORE, EXIT), wait_for_complete_transcription() on trigger, full conversational loop with in-session pagination via nextPageToken
• background.py — daemon polling every 7 days; checks each watchlisted trial for status changes and fires a spoken alert on change; also surfaces a weekly count digest for saved conditions
• KV storage: watchlist of saved trials + saved conditions + preferred location

Data source

• ClinicalTrials.gov REST API v2 — global, 500k+ studies, no API key required

[github-actions]

🔀 Branch Merge Check

PR direction: feature/clinical-trial-finder → dev

✅ Passed — feature/clinical-trial-finder → dev is a valid merge direction

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/clinical-trial-finder
  ✅ All checks passed!

[github-actions]

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

[github-actions]

🔍 Lint Results

✅ __init__.py — Empty as expected

Files linted: community/clinical-trial-finder/background.py community/clinical-trial-finder/main.py

✅ Flake8 — Passed

✅ All checks passed!