From c5421c61f59ea45a193ab84db28f771b94a22894 Mon Sep 17 00:00:00 2001 From: Hongming Wang Date: Wed, 29 Apr 2026 12:55:24 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20fix=20MDX=20build=20=E2=80=94=20escape?= =?UTF-8?q?=20<1=20+=20drop=20Callout=20JSX?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two errors caught by the docs build CI on PR #98: 1. external-agents.mdx line 15 had `<1 min.` — the literal `<` made the MDX parser try to read it as a JSX tag opener. Replaced with prose "under a minute" — equivalent meaning, no escape gymnastics. 2. claude-code-channel-plugin.md used `` JSX, but the rest of /content/docs/guides/ is plain .md (no JSX). The .md loader can't resolve the Callout component → "Cannot handle unknown node `raw`". Replaced with a `> **Note:**` blockquote — same visual hierarchy, plain markdown. Verified locally that the offending characters are gone; build CI on push will re-run and should now pass. --- content/docs/external-agents.mdx | 2 +- content/docs/guides/claude-code-channel-plugin.md | 4 +--- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/content/docs/external-agents.mdx b/content/docs/external-agents.mdx index b43b948..bd3ac8a 100644 --- a/content/docs/external-agents.mdx +++ b/content/docs/external-agents.mdx @@ -26,7 +26,7 @@ stdio server. | Your agent runs as | Best path | Why | |---|---|---| | **An MCP-aware runtime** (Claude Code, Hermes, OpenCode, Cursor, Cline) | [Bring Your Own Runtime (MCP)](/docs/runtime-mcp) | Universal `molecule-mcp` wheel — no HTTP server, no tunnel. | -| **A Claude Code session on your laptop** | [Claude Code Channel Plugin](/docs/guides/claude-code-channel-plugin) | Polling-based; no tunnel/public URL needed. Set up in <1 min. | +| **A Claude Code session on your laptop** | [Claude Code Channel Plugin](/docs/guides/claude-code-channel-plugin) | Polling-based; no tunnel/public URL needed. Set up in under a minute. | | Any HTTP server with a public URL | The flow on this page (or the [Python SDK guide](/docs/guides/external-agent-registration)) | Push-based; lower latency; works for any A2A-compatible HTTP endpoint. | | A custom A2A server you wrote yourself | The flow on this page | Direct register + heartbeat + handler. | diff --git a/content/docs/guides/claude-code-channel-plugin.md b/content/docs/guides/claude-code-channel-plugin.md index 1ea4df4..bfcbe04 100644 --- a/content/docs/guides/claude-code-channel-plugin.md +++ b/content/docs/guides/claude-code-channel-plugin.md @@ -41,9 +41,7 @@ Molecule peer ──A2A──▶ [your workspace] ──poll──▶ [plugin] | Claude Code | `claude` CLI ≥ the version that supports `--channels` | | `bun` | The plugin runs under bun for fast startup; `bun install` is invoked automatically by `start` | - -The platform must be running molecule-core ≥ PR #2300, which shipped the `?since_secs=` query parameter on `GET /workspaces/:id/activity`. Available on all staging-onward and self-hosted main builds after 2026-04-29. - +> **Note:** The platform must be running molecule-core ≥ PR #2300, which shipped the `?since_secs=` query parameter on `GET /workspaces/:id/activity`. Available on all staging-onward and self-hosted main builds after 2026-04-29. ---