@chrysb/alphaclaw 0.8.3 → 0.9.0-beta.0

package/lib/public/js/app.js

@@ -21,6 +21,7 @@ import {
   DoctorRoute,
   EnvarsRoute,
   GeneralRoute,
+  McpRoute,
   ModelsRoute,
   NodesRoute,
   RouteRedirect,
@@ -454,6 +455,9 @@ const App = () => {
                         onNavigateToBrowseFile=${browseActions.navigateToBrowseFile}
                       />
                     </${Route}>
+                    <${Route} path="/mcp">
+                      <${McpRoute} />
+                    </${Route}>
                     <${Route}>
                       <${RouteRedirect} to="/general" />
                     </${Route}>

package/lib/public/js/components/icons.js

@@ -321,6 +321,19 @@ export const SignalTowerLineIcon = ({ className = "" }) => html`
   </svg>
 `;
 
+export const WebhookLineIcon = ({ className = "" }) => html`
+  <svg
+    class=${className}
+    viewBox="0 0 24 24"
+    fill="currentColor"
+    aria-hidden="true"
+  >
+    <path
+      d="M8.86874 14.1392C8.6556 14.4912 8.55014 14.7778 8.72043 15.2253C9.1905 16.4613 8.52737 17.664 7.28097 17.9905C6.10556 18.2985 4.96035 17.526 4.72713 16.2676C4.52048 15.1537 5.38488 14.0617 6.61294 13.8877C6.67963 13.8781 6.74717 13.874 6.83351 13.8688C6.88044 13.866 6.93293 13.8628 6.99384 13.8582L8.86194 10.7257C7.687 9.55742 6.98767 8.19164 7.14246 6.49936C7.25188 5.30308 7.72226 4.26933 8.58208 3.42201C10.2288 1.79945 12.7411 1.53667 14.68 2.78212C16.5423 3.97841 17.3951 6.30867 16.6681 8.30311L14.9611 7.84C15.1895 6.73115 15.0206 5.73536 14.2727 4.88234C13.7786 4.31914 13.1446 4.02394 12.4236 3.91516C10.9783 3.69681 9.55922 4.6254 9.13816 6.04399C8.66019 7.65406 9.38355 8.96924 11.3603 9.96029C10.5311 11.3541 9.70859 12.7518 8.86874 14.1392ZM13.7838 8.27337C14.3816 9.32798 14.9886 10.3986 15.5902 11.4593C18.631 10.5186 20.9237 12.2018 21.7462 14.004C22.7396 16.1809 22.0605 18.7593 20.1094 20.1023C18.1067 21.481 15.5741 21.2454 13.7997 19.4744L15.1919 18.3094C16.9444 19.4445 18.4772 19.3911 19.6151 18.047C20.5855 16.9003 20.5644 15.1906 19.5659 14.068C18.4136 12.7726 16.8701 12.7331 15.0044 13.9767C14.2305 12.6037 13.443 11.2413 12.6936 9.85845C12.4409 9.39233 12.1618 9.12196 11.5923 9.0233C10.6411 8.85839 10.027 8.04157 9.99016 7.12642C9.95395 6.22138 10.4871 5.4033 11.3205 5.08455C12.146 4.7688 13.1148 5.02367 13.6701 5.72554C14.1239 6.29901 14.2681 6.94443 14.0293 7.65167C13.9843 7.7852 13.9304 7.91584 13.8713 8.05885C13.8431 8.12694 13.8138 8.19801 13.7838 8.27337ZM11.552 16.895H15.2126C15.2636 16.963 15.3113 17.0303 15.3579 17.0959C15.4551 17.233 15.5474 17.3632 15.6551 17.4788C16.4304 18.3077 17.7395 18.3489 18.5682 17.5795C19.4271 16.7821 19.466 15.4426 18.6544 14.6101C17.8602 13.7955 16.5029 13.7177 15.7655 14.5802C15.3176 15.1044 14.8586 15.166 14.2641 15.1567C12.7414 15.1332 11.2177 15.149 9.69524 15.149C9.79406 17.2909 8.98436 18.6255 7.37841 18.9424C5.80582 19.2528 4.3575 18.4504 3.84759 16.9864C3.26842 15.3229 3.98467 13.9925 6.05421 12.9366C5.89847 12.3725 5.74115 11.8016 5.58541 11.236C3.32977 11.7276 1.63749 13.916 1.8122 16.378C1.96652 18.5514 3.71968 20.4815 5.86369 20.8273C7.02819 21.0153 8.12233 20.82 9.13741 20.2442C10.4433 19.5032 11.2011 18.3381 11.552 16.895Z"
+    />
+  </svg>
+`;
+
 export const GitBranchLineIcon = ({ className = "" }) => html`
   <svg
     class=${className}
@@ -529,3 +542,27 @@ export const ComputerLineIcon = ({ className = "" }) => html`
     <path d="M4 16H20V5H4V16ZM13 18V20H17V22H7V20H11V18H2.9918C2.44405 18 2 17.5511 2 16.9925V4.00748C2 3.45107 2.45531 3 2.9918 3H21.0082C21.556 3 22 3.44892 22 4.00748V16.9925C22 17.5489 21.5447 18 21.0082 18H13Z" />
   </svg>
 `;
+
+export const PlugLineIcon = ({ className = "" }) => html`
+  <svg
+    class=${className}
+    viewBox="0 0 24 24"
+    fill="currentColor"
+    aria-hidden="true"
+  >
+    <path d="M13 18V20H17V22H7V20H11V18H6C5.44772 18 5 17.5523 5 17V10.0001H3V8.00005H5V6C5 5.44772 5.44772 5 6 5H9V2H11V5H13V2H15V5H18C18.5523 5 19 5.44772 19 6V8.00005H21V10.0001H19V17C19 17.5523 18.5523 18 18 18H13ZM7 7V16H17V7H7Z" />
+  </svg>
+`;
+
+export const LinksLineIcon = ({ className = "" }) => html`
+  <svg
+    class=${className}
+    viewBox="0 0 24 24"
+    fill="currentColor"
+    aria-hidden="true"
+  >
+    <path
+      d="M13.0607 8.11097L14.4749 9.52518C17.2086 12.2589 17.2086 16.691 14.4749 19.4247L14.1214 19.7782C11.3877 22.5119 6.95555 22.5119 4.22188 19.7782C1.48821 17.0446 1.48821 12.6124 4.22188 9.87874L5.6361 11.293C3.68348 13.2456 3.68348 16.4114 5.6361 18.364C7.58872 20.3166 10.7545 20.3166 12.7072 18.364L13.0607 18.0105C15.0133 16.0578 15.0133 12.892 13.0607 10.9394L11.6465 9.52518L13.0607 8.11097ZM19.7782 14.1214L18.364 12.7072C20.3166 10.7545 20.3166 7.58872 18.364 5.6361C16.4114 3.68348 13.2456 3.68348 11.293 5.6361L10.9394 5.98965C8.98678 7.94227 8.98678 11.1081 10.9394 13.0607L12.3536 14.4749L10.9394 15.8891L9.52518 14.4749C6.79151 11.7413 6.79151 7.30911 9.52518 4.57544L9.87874 4.22188C12.6124 1.48821 17.0446 1.48821 19.7782 4.22188C22.5119 6.95555 22.5119 11.3877 19.7782 14.1214Z"
+    />
+  </svg>
+`;

package/lib/public/js/components/mcp-tab/index.js

@@ -0,0 +1,237 @@
+import { h } from "preact";
+import { useState, useCallback } from "preact/hooks";
+import htm from "htm";
+import {
+  fetchMcpInfo,
+  startMcpBridge,
+  stopMcpBridge,
+} from "../../lib/api.js";
+import { usePolling } from "../../hooks/usePolling.js";
+import { showToast } from "../toast.js";
+import { PageHeader } from "../page-header.js";
+import { ActionButton } from "../action-button.js";
+import { PaneShell } from "../pane-shell.js";
+
+const html = htm.bind(h);
+
+const kMcpTools = [
+  { name: "conversations_list", desc: "List recent routed conversations with filters" },
+  { name: "conversation_get", desc: "Return a single conversation by session key" },
+  { name: "messages_read", desc: "Retrieve transcript history for a conversation" },
+  { name: "attachments_fetch", desc: "Extract non-text content metadata from messages" },
+  { name: "events_poll", desc: "Read queued live events since a cursor position" },
+  { name: "events_wait", desc: "Long-poll for next matching event with timeout" },
+  { name: "messages_send", desc: "Send text replies through existing routes" },
+  { name: "permissions_list_open", desc: "List pending exec/plugin approval requests" },
+  { name: "permissions_respond", desc: "Resolve approvals (allow-once, allow-always, deny)" },
+];
+
+const StatusDot = ({ active }) => html`
+  <span
+    class="inline-block w-2 h-2 rounded-full shrink-0 ${active
+      ? "bg-green-500"
+      : "bg-gray-600"}"
+  />
+`;
+
+const buildConfigSnippet = ({ origin, token }) => {
+  const encodedToken = encodeURIComponent(String(token || ""));
+  const sseUrl = `${origin}/mcp/sse?token=${encodedToken}`;
+  return JSON.stringify(
+    {
+      mcpServers: {
+        openclaw: {
+          url: sseUrl,
+        },
+      },
+    },
+    null,
+    2,
+  );
+};
+
+export const McpTab = () => {
+  const [acting, setActing] = useState(false);
+
+  const {
+    data: info,
+    refresh,
+  } = usePolling(fetchMcpInfo, 8000, {
+    cacheKey: "/api/mcp/info",
+  });
+  const loading = !info;
+
+  const running = !!info?.running;
+  const tokenAvailable = !!info?.tokenAvailable;
+  const gatewayToken = info?.gatewayToken || "";
+
+  const handleStart = useCallback(async () => {
+    if (acting) return;
+    setActing(true);
+    try {
+      const result = await startMcpBridge();
+      if (result?.ok) {
+        showToast(
+          result.alreadyRunning
+            ? "MCP bridge already running"
+            : "MCP bridge started",
+          "success",
+        );
+      } else {
+        showToast("Failed to start MCP bridge", "error");
+      }
+      await refresh({ force: true });
+    } catch (err) {
+      showToast("Failed to start: " + err.message, "error");
+    } finally {
+      setActing(false);
+    }
+  }, [acting, refresh]);
+
+  const handleStop = useCallback(async () => {
+    if (acting) return;
+    setActing(true);
+    try {
+      const result = await stopMcpBridge();
+      if (result?.ok) {
+        showToast("MCP bridge stopped", "success");
+      } else {
+        showToast("Failed to stop MCP bridge", "error");
+      }
+      await refresh({ force: true });
+    } catch (err) {
+      showToast("Failed to stop: " + err.message, "error");
+    } finally {
+      setActing(false);
+    }
+  }, [acting, refresh]);
+
+  const handleCopy = useCallback(() => {
+    const origin = window.location.origin;
+    const snippet = buildConfigSnippet({ origin, token: gatewayToken });
+    navigator.clipboard
+      .writeText(snippet)
+      .then(() => showToast("Copied to clipboard", "success"))
+      .catch(() => showToast("Failed to copy", "error"));
+  }, [gatewayToken]);
+
+  const configSnippet = buildConfigSnippet({
+    origin: typeof window !== "undefined" ? window.location.origin : "https://your-host",
+    token: gatewayToken || "<gateway-token>",
+  });
+
+  if (loading && !info) {
+    return html`
+      <${PaneShell} header=${html`<${PageHeader} title="MCP" />`}>
+        <div class="bg-surface border border-border rounded-xl p-4 text-sm text-fg-muted">
+          Loading...
+        </div>
+      </${PaneShell}>
+    `;
+  }
+
+  return html`
+    <${PaneShell}
+      header=${html`
+        <${PageHeader}
+          title="MCP"
+          actions=${html`
+            ${running
+              ? html`<${ActionButton}
+                  onClick=${handleStop}
+                  disabled=${acting}
+                  loading=${acting}
+                  loadingMode="inline"
+                  tone="secondary"
+                  size="sm"
+                  idleLabel="Stop bridge"
+                  loadingLabel="Stopping…"
+                  className="text-xs"
+                />`
+              : html`<${ActionButton}
+                  onClick=${handleStart}
+                  disabled=${acting}
+                  loading=${acting}
+                  loadingMode="inline"
+                  tone="primary"
+                  size="sm"
+                  idleLabel="Start bridge"
+                  loadingLabel="Starting…"
+                  className="text-xs"
+                />`}
+          `}
+        />
+      `}
+    >
+      <!-- Status -->
+      <div class="bg-surface border border-border rounded-xl overflow-hidden">
+        <h3 class="card-label text-xs px-4 pt-3 pb-2">Status</h3>
+        <div class="px-4 pb-3 space-y-2">
+          <div class="flex items-center gap-2 text-sm">
+            <${StatusDot} active=${running} />
+            <span class="text-body">
+              MCP Bridge: ${running ? "Running" : "Stopped"}
+            </span>
+            ${running && info?.pid
+              ? html`<span class="text-fg-dim text-xs">(PID ${info.pid})</span>`
+              : null}
+          </div>
+          <div class="flex items-center gap-2 text-sm">
+            <${StatusDot} active=${tokenAvailable} />
+            <span class="text-body">
+              Gateway token: ${tokenAvailable ? "Configured" : "Not set"}
+            </span>
+          </div>
+          ${info?.gatewayWsUrl
+            ? html`<div class="text-xs text-fg-dim">
+                Gateway: <code class="bg-field px-1 rounded">${info.gatewayWsUrl}</code>
+              </div>`
+            : null}
+        </div>
+      </div>
+
+      <!-- Config Snippet -->
+      <div class="bg-surface border border-border rounded-xl overflow-hidden">
+        <div class="flex items-center justify-between px-4 pt-3 pb-2">
+          <h3 class="card-label text-xs">Client Config</h3>
+          <button
+            onclick=${handleCopy}
+            class="text-xs px-2 py-0.5 rounded border border-border text-fg-muted hover:text-body hover:border-fg-muted"
+          >
+            Copy
+          </button>
+        </div>
+        <div class="px-4 pb-3">
+          <p class="text-xs text-fg-dim mb-2">
+            Add this to your MCP client config (Cursor, Claude Desktop, etc.):
+          </p>
+          <pre
+            class="bg-field border border-border rounded-lg p-3 text-xs text-body font-mono overflow-x-auto whitespace-pre"
+          >${configSnippet}</pre>
+          ${!running
+            ? html`<p class="text-xs text-status-warning-muted mt-2">
+                Start the MCP bridge above before connecting a client.
+              </p>`
+            : null}
+        </div>
+      </div>
+
+      <!-- Available Tools -->
+      <div class="bg-surface border border-border rounded-xl overflow-hidden">
+        <h3 class="card-label text-xs px-4 pt-3 pb-2">Available Tools</h3>
+        <div class="divide-y divide-border">
+          ${kMcpTools.map(
+            (tool) => html`
+              <div class="flex items-start gap-3 px-4 py-2">
+                <code class="text-xs shrink-0 pt-0.5" style="min-width: 170px"
+                  >${tool.name}</code
+                >
+                <span class="text-xs text-fg-dim">${tool.desc}</span>
+              </div>
+            `,
+          )}
+        </div>
+      </div>
+    </${PaneShell}>
+  `;
+};

package/lib/public/js/components/routes/chat-route.js

@@ -870,8 +870,15 @@ export const ChatRoute = ({ sessions = [], selectedSessionKey = "" }) => {
         <div>
           <div class="chat-route-title">Chat</div>
           <div class="chat-route-subtitle">
-            ${getSessionDisplayLabel(selectedSession) ||
-            "Pick a session in the sidebar"}
+            <span class="chat-route-subtitle-label"
+              >${getSessionDisplayLabel(selectedSession) ||
+              "Pick a session in the sidebar"}</span
+            >
+            ${selectedSessionKey
+              ? html`<span class="chat-route-session-key" title="Session key"
+                  >${selectedSessionKey}</span
+                >`
+              : null}
           </div>
           ${connectionError
             ? html`<div class="chat-route-warning">${connectionError}</div>`

package/lib/public/js/components/routes/index.js

@@ -5,6 +5,7 @@ export { CronRoute } from "./cron-route.js";
 export { DoctorRoute } from "./doctor-route.js";
 export { EnvarsRoute } from "./envars-route.js";
 export { GeneralRoute } from "./general-route.js";
+export { McpRoute } from "./mcp-route.js";
 export { ModelsRoute } from "./models-route.js";
 export { NodesRoute } from "./nodes-route.js";
 export { ProvidersRoute } from "./providers-route.js";

package/lib/public/js/components/routes/mcp-route.js

@@ -0,0 +1,7 @@
+import { h } from "preact";
+import htm from "htm";
+import { McpTab } from "../mcp-tab/index.js";
+
+const html = htm.bind(h);
+
+export const McpRoute = () => html`<${McpTab} />`;

package/lib/public/js/components/sidebar.js

@@ -12,10 +12,11 @@ import {
   ComputerLineIcon,
   EyeLineIcon,
   FolderLineIcon,
+  LinksLineIcon,
   HomeLineIcon,
   PulseLineIcon,
   RobotLineIcon,
-  SignalTowerLineIcon,
+  WebhookLineIcon,
 } from "./icons.js";
 import { FileTree } from "./file-tree.js";
 import { OverflowMenu, OverflowMenuItem } from "./overflow-menu.js";
@@ -57,8 +58,9 @@ const kSidebarNavIconsById = {
   watchdog: EyeLineIcon,
   models: Brain2LineIcon,
   envars: BracesLineIcon,
-  webhooks: SignalTowerLineIcon,
+  webhooks: WebhookLineIcon,
   nodes: ComputerLineIcon,
+  mcp: LinksLineIcon,
 };
 
 const readStoredBrowseBottomPanelHeight = () => {

package/lib/public/js/lib/api.js

@@ -1365,3 +1365,20 @@ export const syncBrowseChanges = async (message = "") => {
   });
   return parseJsonOrThrow(res, "Could not sync changes");
 };
+
+// ── MCP ──────────────────────────────────────────────────────────
+
+export const fetchMcpInfo = async () => {
+  const res = await authFetch("/api/mcp/info");
+  return res.json();
+};
+
+export const startMcpBridge = async () => {
+  const res = await authFetch("/api/mcp/start", { method: "POST" });
+  return res.json();
+};
+
+export const stopMcpBridge = async () => {
+  const res = await authFetch("/api/mcp/stop", { method: "POST" });
+  return res.json();
+};

package/lib/public/js/lib/app-navigation.js

@@ -23,6 +23,7 @@ export const kNavSections = [
       { id: "envars", label: "Envars" },
       { id: "webhooks", label: "Webhooks" },
       { id: "nodes", label: "Nodes" },
+      { id: "mcp", label: "MCP" },
     ],
   },
 ];
@@ -41,5 +42,6 @@ export const getSelectedNavId = ({ isBrowseRoute = false, location = "" } = {})
   if (location.startsWith("/nodes")) return "nodes";
   if (location.startsWith("/envars")) return "envars";
   if (location.startsWith("/webhooks")) return "webhooks";
+  if (location.startsWith("/mcp")) return "mcp";
   return kDefaultUiTab;
 };

package/lib/server/init/register-server-routes.js

@@ -17,6 +17,7 @@ const { registerDoctorRoutes } = require("../routes/doctor");
 const { registerAgentRoutes } = require("../routes/agents");
 const { registerCronRoutes } = require("../routes/cron");
 const { registerNodeRoutes } = require("../routes/nodes");
+const { registerMcpRoutes } = require("../routes/mcp");
 const {
   createOauthCallbackMiddleware,
 } = require("../oauth-callback-middleware");
@@ -249,6 +250,13 @@ const registerServerRoutes = ({
     gatewayToken: constants.GATEWAY_TOKEN,
     fsModule: fs,
   });
+  registerMcpRoutes({
+    app,
+    requireAuth,
+    constants,
+    gatewayEnv,
+    openclawDir: constants.OPENCLAW_DIR,
+  });
   registerProxyRoutes({
     app,
     proxy,

package/lib/server/mcp-bridge.js

@@ -0,0 +1,158 @@
+const { spawn } = require("child_process");
+
+const kStderrTailLines = 50;
+
+let mcpChild = null;
+let mcpStartedAt = null;
+let mcpStderrTail = [];
+let stdoutBuffer = Buffer.alloc(0);
+let onMcpMessage = null;
+
+const appendStderrTail = (chunk) => {
+  const text = Buffer.isBuffer(chunk)
+    ? chunk.toString("utf8")
+    : String(chunk ?? "");
+  for (const line of text.split("\n")) {
+    const trimmed = line.trimEnd();
+    if (!trimmed) continue;
+    mcpStderrTail.push(trimmed);
+  }
+  if (mcpStderrTail.length > kStderrTailLines) {
+    mcpStderrTail = mcpStderrTail.slice(-kStderrTailLines);
+  }
+};
+
+const isMcpBridgeRunning = () =>
+  mcpChild !== null && mcpChild.exitCode === null && !mcpChild.killed;
+
+const getMcpBridgeStatus = () => ({
+  running: isMcpBridgeRunning(),
+  pid: isMcpBridgeRunning() ? mcpChild.pid : null,
+  startedAt: isMcpBridgeRunning() ? mcpStartedAt : null,
+  stderrTail: mcpStderrTail.slice(-10),
+});
+
+const setOnMcpMessage = (callback) => {
+  onMcpMessage = typeof callback === "function" ? callback : null;
+};
+
+const drainStdoutLines = () => {
+  while (stdoutBuffer.length > 0) {
+    const newlineIndex = stdoutBuffer.indexOf("\n");
+    if (newlineIndex === -1) break;
+
+    const line = stdoutBuffer.toString("utf8", 0, newlineIndex).replace(/\r$/, "");
+    stdoutBuffer = stdoutBuffer.slice(newlineIndex + 1);
+    if (!line.trim()) continue;
+
+    let parsed = null;
+    try {
+      parsed = JSON.parse(line);
+    } catch {
+      appendStderrTail(`Unparseable MCP stdout line: ${line.slice(0, 120)}`);
+      continue;
+    }
+    console.log(`[mcp-bridge] ← child stdout: method=${parsed?.method || "(response)"} id=${parsed?.id ?? "none"}`);
+    if (onMcpMessage) {
+      try {
+        onMcpMessage(parsed);
+      } catch (err) {
+        appendStderrTail(`onMcpMessage error: ${err?.message || err}`);
+      }
+    }
+  }
+};
+
+const startMcpBridge = ({ gatewayEnv, gatewayWsUrl, gatewayToken }) => {
+  if (isMcpBridgeRunning()) {
+    return { ok: true, alreadyRunning: true, ...getMcpBridgeStatus() };
+  }
+
+  const args = ["mcp", "serve"];
+  if (gatewayWsUrl) {
+    args.push("--url", gatewayWsUrl);
+  }
+  const childEnv = gatewayEnv();
+  if (gatewayToken) {
+    childEnv.OPENCLAW_GATEWAY_TOKEN = String(gatewayToken);
+  }
+
+  mcpStderrTail = [];
+  stdoutBuffer = Buffer.alloc(0);
+
+  const child = spawn("openclaw", args, {
+    env: childEnv,
+    stdio: ["pipe", "pipe", "pipe"],
+  });
+
+  mcpChild = child;
+  mcpStartedAt = Date.now();
+
+  child.stdout.on("data", (data) => {
+    const chunk = Buffer.isBuffer(data)
+      ? data
+      : Buffer.from(String(data ?? ""), "utf8");
+    stdoutBuffer = Buffer.concat([stdoutBuffer, chunk]);
+    drainStdoutLines();
+  });
+
+  child.stderr.on("data", (data) => {
+    appendStderrTail(data);
+    process.stderr.write(`[mcp-bridge] ${data}`);
+  });
+
+  child.on("exit", (code, signal) => {
+    console.log(
+      `[mcp-bridge] Process exited with code ${code}${signal ? ` signal ${signal}` : ""}`,
+    );
+    if (mcpChild === child) mcpChild = null;
+    mcpStartedAt = null;
+  });
+
+  child.on("error", (error) => {
+    appendStderrTail(error?.message || String(error || "unknown process error"));
+    console.error(
+      `[mcp-bridge] Process failed to start: ${error?.message || error}`,
+    );
+  });
+
+  console.log(`[mcp-bridge] Started MCP bridge (pid ${child.pid})`);
+  return { ok: true, alreadyRunning: false, ...getMcpBridgeStatus() };
+};
+
+const stopMcpBridge = () => {
+  if (!isMcpBridgeRunning()) {
+    return { ok: true, wasStopped: true };
+  }
+  const pid = mcpChild.pid;
+  mcpChild.kill("SIGTERM");
+  mcpChild = null;
+  mcpStartedAt = null;
+  console.log(`[mcp-bridge] Stopped MCP bridge (pid ${pid})`);
+  return { ok: true, wasStopped: false };
+};
+
+const writeToMcpBridge = (jsonRpcMessage) => {
+  if (!isMcpBridgeRunning()) return false;
+  if (jsonRpcMessage == null) return false;
+  const payload =
+    typeof jsonRpcMessage === "string"
+      ? jsonRpcMessage
+      : JSON.stringify(jsonRpcMessage);
+  if (!payload) return false;
+  const method = jsonRpcMessage?.method;
+  const id = jsonRpcMessage?.id;
+  const payloadBytes = Buffer.byteLength(payload, "utf8");
+  console.log(`[mcp-bridge] → child stdin: method=${method || "(response)"} id=${id ?? "none"} bytes=${payloadBytes}`);
+  mcpChild.stdin.write(`${payload}\n`);
+  return true;
+};
+
+module.exports = {
+  isMcpBridgeRunning,
+  getMcpBridgeStatus,
+  startMcpBridge,
+  stopMcpBridge,
+  writeToMcpBridge,
+  setOnMcpMessage,
+};