Skip to content

demo: polish Streamable HTTP demo with README, CLI args, and coherent BRAF/melanoma scenario#198

Merged
imaurer merged 1 commit intomainfrom
streamable-http-demo-polish
Mar 11, 2026
Merged

demo: polish Streamable HTTP demo with README, CLI args, and coherent BRAF/melanoma scenario#198
imaurer merged 1 commit intomainfrom
streamable-http-demo-polish

Conversation

@imaurer
Copy link
Collaborator

@imaurer imaurer commented Mar 11, 2026

Summary

  • Adds demo/README.md with clear sections for what the demo proves, how to start the server, how to run the client, and what output to expect
  • Replaces hardcoded scenario constant with a --scenario CLI argument so users can select scenarios without editing source
  • Tightens the default braf-melanoma scenario: the final trial search step is now melanoma-scoped (returning 5 of 104 matched trials instead of 455 broad results), keeping the narrative coherent end-to-end
  • Adds a /health probe with bounded timeout and actionable startup guidance on failure, so the script doubles as an operator smoke check
  • Documents --quiet flag in run commands to suppress first-run uv dependency noise
  • Adds 7 demo-specific tests covering health probe timeout regression, CLI argument parsing, and all required scenario output markers

Test plan

  • uv run --quiet --script demo/streamable_http_client.py --help shows usage with --scenario arg
  • uv run --quiet --script demo/streamable_http_client.py --scenario invalid exits with invalid choice error
  • uv run --quiet --script demo/streamable_http_client.py http://127.0.0.1:9999 exits with Health check failed + startup guidance
  • Full run against biomcp serve-http: prints Health check passed, Available tools: biomcp, step-3 echo condition=melanoma, mutation=BRAF V600E
  • pytest tests/ -q — 43 passed, 0 failed

… BRAF/melanoma scenario

- Add demo/README.md with what/how/expect sections aligned to demo output
- Add --scenario CLI argument for scenario selection without source edits
- Tighten default braf-melanoma scenario: step 3 is now melanoma-scoped (5 of 104 results vs 455)
- Add /health probe with bounded timeout and startup guidance on failure
- Suppress uv dependency noise via --quiet flag in documented run commands
- Add 7 demo-specific tests covering health probe timeout, CLI arg parsing, and scenario markers
- Update remote-http.md docs and technical overview to reflect changes
@imaurer imaurer merged commit d9d2b88 into main Mar 11, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant