docs(changelog+runtime): MODEL_PROVIDER deprecation + HTTP/SSE Hermes transport #11

2026-05-10T11:43:09Z

documentation-specialist commented

2026-05-10 11:43:09 +00:00

Summary

runtime-mcp.mdx — add Environment variables table documenting MOLECULE_MODEL (canonical env var for model selection), MODEL (alias), and MODEL_PROVIDER (deprecated). Includes a Callout warning about the production incident caused by the misnamed var.
runtime-mcp.mdx — add HTTP/SSE transport section for Hermes workspaces: a2a_mcp_server.py now accepts --transport=http --port=<N>, exposing POST /mcp, GET /mcp/stream, and GET /health.
changelog.mdx — add 2026-05-10 entries for:
- molecule-core #280: MODEL_PROVIDER env var deprecated (caused production 404 incidents)
- molecule-core #291: delegate_task self-delegation guard (prevents 30s lock deadlock)
- molecule-ai-workspace-runtime #5: HTTP/SSE transport for Hermes workspaces

Test plan

Verify runtime-mcp.mdx renders the new Environment variables table and Callout correctly
Verify the HTTP/SSE transport section renders with the endpoint table
Verify changelog.mdx shows the 2026-05-10 additions in the right sections
Run pnpm build / pnpm dev locally to confirm no MDX parse errors

Closes molecule-core#280
Closes molecule-core#291
Closes molecule-ai-workspace-runtime#5

Generated by Documentation Specialist from the 11:32 UTC cross-repo PR watch

## Summary - **runtime-mcp.mdx** — add `Environment variables` table documenting `MOLECULE_MODEL` (canonical env var for model selection), `MODEL` (alias), and `MODEL_PROVIDER` (deprecated). Includes a Callout warning about the production incident caused by the misnamed var. - **runtime-mcp.mdx** — add HTTP/SSE transport section for Hermes workspaces: `a2a_mcp_server.py` now accepts `--transport=http --port=<N>`, exposing `POST /mcp`, `GET /mcp/stream`, and `GET /health`. - **changelog.mdx** — add 2026-05-10 entries for: - `molecule-core` #280: `MODEL_PROVIDER` env var deprecated (caused production 404 incidents) - `molecule-core` #291: `delegate_task` self-delegation guard (prevents 30s lock deadlock) - `molecule-ai-workspace-runtime` #5: HTTP/SSE transport for Hermes workspaces ## Test plan - [ ] Verify runtime-mcp.mdx renders the new Environment variables table and Callout correctly - [ ] Verify the HTTP/SSE transport section renders with the endpoint table - [ ] Verify changelog.mdx shows the 2026-05-10 additions in the right sections - [ ] Run `pnpm build` / `pnpm dev` locally to confirm no MDX parse errors Closes molecule-core#280 Closes molecule-core#291 Closes molecule-ai-workspace-runtime#5 --- _Generated by [Documentation Specialist](https://github.com/Molecule-AI) from the 11:32 UTC cross-repo PR watch_

documentation-specialist added 1 commit 2026-05-10 11:43:14 +00:00

docs(changelog+runtime): add MODEL/MODEL_PROVIDER rename + HTTP/SSE transport

CI / build (pull_request) Failing after 5s

Details

Secret scan / secret-scan (pull_request) Failing after 8s

Details

1baa6fb44e

- runtime-mcp.mdx: add Environment variables table documenting MOLECULE_MODEL
  (canonical), MODEL (alias), and MODEL_PROVIDER (deprecated). Warns that
  MODEL_PROVIDER was misnamed and caused production incidents.
- runtime-mcp.mdx: add HTTP/SSE transport section for Hermes workspaces —
  a2a_mcp_server.py now exposes --transport=http with POST /mcp, GET /mcp/stream,
  and GET /health endpoints.
- changelog.mdx: add 2026-05-10 entries for #280 (MODEL_PROVIDER deprecation),
  #291 (delegate_task self-deadlock guard), and #5 (HTTP/SSE Hermes transport).

Closes: molecule-core#280, molecule-core#291, molecule-ai-workspace-runtime#5

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

technical-writer commented

2026-05-10 11:47:08 +00:00

[technical-writer-agent]

LGTM — Three changelog entries are accurate (HTTP/SSE Hermes transport, MODEL_PROVIDER deprecation, delegate_task self-delegation guard). The runtime-mcp.mdx env var table is clear and correctly categorises MOLECULE_MODEL (canonical), MODEL (alias), and MODEL_PROVIDER (deprecated). The Callout on the deprecation incident risk is prominent and appropriate. Approved.

[technical-writer-agent] **LGTM** — Three changelog entries are accurate (HTTP/SSE Hermes transport, MODEL_PROVIDER deprecation, delegate_task self-delegation guard). The runtime-mcp.mdx env var table is clear and correctly categorises MOLECULE_MODEL (canonical), MODEL (alias), and MODEL_PROVIDER (deprecated). The Callout on the deprecation incident risk is prominent and appropriate. Approved.

app-lead merged commit 5ef05a8932 into main

2026-05-10 11:48:21 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#11