@nyosegawa/agent-ui-server

@nyosegawa/agent-ui-server

Node local bridge helpers for Agent UI.

Use this package when a host application needs local WebSocket bridge helpers, upload handling, or one-shot RPC utilities around Codex App Server.

Install

bun add @nyosegawa/agent-ui-server @nyosegawa/agent-ui-core @nyosegawa/agent-ui-codex

Common Imports

Use case	Import
Full-chat WebSocket bridge	import { attachAgentUiWebSocketBridge } from "@nyosegawa/agent-ui-server";
Lower-level upgraded-socket handler	import { handleAgentUiWebSocketConnection } from "@nyosegawa/agent-ui-server";
Local media upload/static helper	import { createAgentUiLocalMediaHelper } from "@nyosegawa/agent-ui-server";
One-shot RPC helpers	import { createAgentUiNextRpcRoute, createAgentUiExpressMiddleware } from "@nyosegawa/agent-ui-server";
Bearer WebSocket subprotocol verification	import { verifyAgentUiBearerSubprotocol } from "@nyosegawa/agent-ui-server";
Raw stdio/process ownership	import { createCodexAppServerBridge } from "@nyosegawa/agent-ui-server/advanced";

Package Boundary

Use the package root for normal host integration: WebSocket bridges, local media, one-shot RPC, method policy, server-request policy, dynamic-tool policy, redaction, and host-event helpers. Use /advanced only when the host deliberately owns raw stdio process composition.

This package provides bridge helpers. Host applications own process lifecycle, authorization, network exposure, deployment topology, persistence, and resource policy.

Use explicit bridge admission, browser method policy, one-shot method policy, dynamic-tool policy, local media serving, redaction, and host event sinks. Non-loopback bridges, upload/static authorization, tenant/workspace isolation, audit storage, billing, and deployment policy remain host-owned.

See the repository docs for current package exports and integration guidance: https://github.com/nyosegawa/agent-ui