Function dispatch

apps/memos-local-plugin/server/http.ts:120–238

(
  req: IncomingMessage,
  res: ServerResponse,
  routes: ReturnType<typeof buildRoutes>,
  deps: ServerDeps,
  options: ServerOptions,
  log: ReturnType<typeof rootLogger.child>,
)

}

async function dispatch(
  req: IncomingMessage,
  res: ServerResponse,
  routes: ReturnType<typeof buildRoutes>,
  deps: ServerDeps,
  options: ServerOptions,
  log: ReturnType<typeof rootLogger.child>,
): Promise<void> {
  const url = new URL(req.url ?? "/", "http://localhost");
  const method = (req.method ?? "GET").toUpperCase();
  let pathname = url.pathname;

  const selfAgent = (options.agent ?? null) as AgentName | null;

  // Backwards-compat for the old single-port "hub/peer" layout, where
  // every URL was prefixed (`/openclaw/api/v1/...` or
  // `/hermes/...`). New installs serve the SPA at root, but old
  // bookmarks (and the old `AGENT_PREFIX` baked into older viewer
  // bundles) still hit the prefixed paths.
  //
  // Two cases:
  //   - Prefix matches THIS agent → drop the prefix and continue
  //     dispatching internally. We must NOT 302 here, because POST /
  //     PATCH / DELETE get downgraded to GET on a 302 in most browsers,
  //     which would silently corrupt mutations.
  //   - Prefix matches the OTHER agent → that agent lives on its own
  //     port now, so 302 the user there. (We accept the request-method
  //     downgrade because cross-port redirects are inherently a "follow
  //     this link" gesture; the SPA bundle on the other port re-issues
  //     mutations from form state, not from the original POST body.)
  for (const name of AGENT_PREFIXES) {
    const prefix = `/${name}`;
    if (pathname === prefix || pathname.startsWith(`${prefix}/`)) {
      const tail = pathname.slice(prefix.length) || "/";
      if (name === "memos" || name === selfAgent) {
        pathname = tail;
        break;
      }
      const peerPort = AGENT_DEFAULT_PORTS[name];
      const targetHost = req.headers["host"]?.split(":")[0] ?? "127.0.0.1";
      res.writeHead(302, {
        Location: `http://${targetHost}:${peerPort}${tail}${url.search}`,
      });
      res.end();
      return;
    }
  }

  // Static assets first — cheapest path. Serve on GET/HEAD only.
  // The root path falls through to the static handler which serves
  // `index.html` (the SPA). There is no picker page: each agent owns
  // its own port and is reachable directly. The SPA's header probes
  // the peer's well-known port and surfaces a small link if it's up.
  if ((method === "GET" || method === "HEAD") && !pathname.startsWith("/api/")) {
    const served = await serveStatic(res, pathname, options);
    if (served) return;
  }